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THIS MANUAL 



... is intended to guide System/370 operators and programmers using DOS/VS in 
determining and isolating the cause of a system malfunction. 

METHOD OF PRESENT A TION 

Serviceability aids and how to use them, are described in this manual through 
extensive use of diagrams and examples. This enables fast retrieval of information 
and largely avoids the need to use other publications in order to analyze the dumps 
and printouts discussed. 

Contents and addresses shown in the illustrations are subject to change and are 
shown only as an aid to offline debugging of DOS/VS. IBM will not 
be responsible for any system malfunction resulting from a change made by the 
user of any contents or addresses of the tables and blocks described, 

SUBJECTS COVERED 

There are four major sections; 

SECTION 1: Introduction, introduces the serviceability aids detailed in Section 2, 
and the debugging procedures described in Sections 3 and 4. 

SECTION 2: Serviceability Aids, describes in detail the serviceabiHty aids, 
showing in flowchart form how to use them, and recommending when to use them. 
Examples show how to analyze dumps and printouts in conjunction with the 
debugging procedures of Sections 3 and 4. 

SECTION 3: Debugging for Operators, consists of flowcharts that help the 
operator to isolate the cause of a system malfunction. The operator is instructed 
when to use the procedures of Section 2 to ensure that information is gathered 
from the system. 

SECTION 4: Debugging for programmers, this section is divided into two parts; 

Part I consists of checklists in flowchart form that recommend the method of 
analysis and choice of serviceability aids best suited to isolate the cause of a given 
type of system malfunction. An indication is made on the flowcharts when it is 
considered necessary to inform your IBM customer engineer when itis not 
possible to isolate the cause of an error. System information to be saved for the 
IBM CE is also listed at these points in the flowcharts. 

Part 2 is a general description of the DOS/VS supervisor/problem program interface 
tables, information blocks and save areas. It shows how to locate these areas in a 
dump, and how to analyze the data during offline program debugging. Debugging 
aids for high level languages are described in publications dealing with the specific 
language, 

PREREOUISITE KNOWLEDGE 

Operators using this manual must be familiar with the following IBM publications: 

DOS/ VS Operating Procedures GC33 -5378 

DOS I VS Messages GC33 - 53 79 

Programmers using Section 4 must be familiar with the following IBM publications: 

IBM System/370 Principles of Operation GA22 - 7000 

DOS/VS System Management Guide GC33 - 5371 

Other IBM pubHcations referenced in this manual are listed in the bibliography at 
the back. 
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Hands-on debugging 



Detect and 
categorize 
the error. 
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using serviceability aids. 
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Offline debugging 



Analyze the 
information, 
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Use special "tools' 
if further error 
isolation required. 
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Serviceability Aids 
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Serviceability aids are "tools" offered by IBM and are designed to gather system 
information whenever a malfunction occurs on a System/370. 

A malfunction can be caused by a programming error or by a hardware failure. 

Some of the serviceability aids that gather system information when 
programming errors occur are: 

• DUMPS of specified real and virtual address areas 

• DUMPS or DISPLAYS of general registers, 

control registers, 

floating point registers, and 

program status words 

• FORMATTED PRINTOUT of the DOS/VS supervisor tables and 
information blocks 

• The abiUty to ALTER any register or any area of virtual storage 

• Problem cfetermination aids, PDAIDS (event tracing routines) 

• System debugging aids, SDAIDS (program event recording and 
tracing routines) 

• Disk and tape LABEL INFORMATION display programs 

• LISTIO and MAP commands (aids that list devices used per partition, 
and that map virtual storage organization during system operation) 

• Commands that allow information contained on disk files using VSAM 
(Virtual Storage Access Method) to be printed, listed, or verified 

• Programs that display libraries and allow them to be edited and 
maintained 

• Error messages issued by the system that inform the operator about 
the nature of an error. 

The serviceability aids that detect hardware failures and produce formatted output 
concerning this failure are: 

• RMS - Recovery Management Support 

• EREP — Environmental Recording, Editing, and Printing 

• OLTEP — Onhne Test Executive Program 

• TOLTEP-Teleprocessing Online Test Executive Program 

• SEREP - Stand-alone EREP 

Micro-program diagnostic aids, (Models 115, 125, and 158) 

In addition to the above aids, the Models 115 and 125 are provided with a micro- 
program recording facility that records certain types of hardware errors on the 
console file. The errors recorded on the console file can be displayed and analyzed 
by the IBM CE using the Maintenance Program Selection and Log Analysis displays. 

A similar facility is provided on the Model 158 in the form of displays obtained 
by the use of the Service function. 

A reference chart at the front of Section 2 Usts the IBM serviceability aids, which 
are described in detail in that section. 

Serviceabihty aids offered by IBM that are designed to gather system information 
specifically for use with high-level languages (RPG II, PL/I, American National 
Standard COBOL, and FORTRAN) are not described in this manual. Details about 
these aids are found in the corresponding manuals for the processor being used. 
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What is Debugging? 

Debugging is a procedure that is followed to isolate an error (sometimes referred 

to as a bug) that prevents programs from being correctly executed by a computer ,| t: 

system. V^ 



Debugging requires the coordinated efforts of operators and programmers, and is 
divided into two distinct actions: 

• Hands-on debugging 

• Offline debugging. 

Hands-on debugging entails the examination of available symptoms and 
indications and the saving of information by the operator when a system 
malfunction occurs. 

Offline debugging requires the analysis and the isolation of an error by the 
programmer, using data gathered during hands-on debugging. 

IBM has provided special programs, commands, and procedures called service- 
abihty aids, or tools, to help in gathering information about a system malfunction. 
These aids can be initialized by the operator and are of special interest when an 
error is obscure. 

The two debugging actions (hands-on and offline) can be divided into the 
following four phases as shown in figure 1.1: 

1, Determine the type of malfunction. 

2. Gather information. 

3, Analyze the information, 

4. Use aids for further error isolation if required. 
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What is Debugging^ 



OPERATORS 



Phase 1 



Recognize the error type: 

• Unintended loop 

• Wait state 

• Incorrect output 

• Program checks 

• I/O device errors 
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Gather information: 




Message from SYS LOG 




Line printer output 




Dumps 




A MAP of virtual storage 




ALISTIOof 1/Odevice 




assignments 




Low address storage 




System activity 




Indicator lamps 




EREP or SEREP output 




Models 115/125 Log 




analysis displays 




Model 158 display frames 




Loop traces 





Program logic 



Error messages 
and Dumps 
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PROGRAMMERS 




Phase 3 


Iso 


late the error: 




Error messages 




JCL errors 




Incorrect macros 




Linkage editor errors 




Source code errors 




Loop traces 




I/O data file errors 




Flowcharting errors 
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Figure 1-1 . The four phases of debugging 



Phase 4 



Further error isolation: 

• Trace routines 

• Operator's console 

• Supervisor communication 
macros 

• Library and service programs 
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System Malfunctions 



Generally speaking, a system malfunction is said to have occurred whenever a 
program did not do what it was expected to do. A system malfunction can be 
due to one or more of the following: 

• An operator error or job set (JCL) 

• An error in the program logic, a coding error, or 
the misuse of instructions 

• A hardware failure 

• An unusual circumstance during program execution. 



Because of the many circumstances in which errors may occur, system malfunctions 
manifest themselves in different ways. 

The physical size of a given system, its environment, and the type of programs used 
also play a part in how a particular error affects system operation. 



During single-partition batch jobs (BJ) 

In this type of environment, the easiest way to recover from an error is to cancel 
the job and begin it again from the IPL procedure. However, to deal with a 
program that has been operating successfully for several hours prior to the error, 
alternative methods must be used. 

Also in this type of environment, operators "get to know" the programs and can 
recognize when the programs do not appear to be performing the same as before. 
Hands-on debugging can be performed without interfering with the execution 
of other jobs. 



Multiprogramming environment (MPS) 

To cancel, re-IPL, and restart jobs after a malfunction in this type of environment 
would delay both production and debugging procedures. Hands-on debugging is 
more difficult than with BJ, and the method used to gather information must be 
carefully chosen. It is also impossible to "get to know," by repeated use of the 
same programs, exactly what each job should be doing at any given time, and so it 
is more difficult to recognize a system malfunction. 
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Teleprocessing (TP) 

Since teleprocessing is normally executed on multi-programming systems, the 
same problems are met as those described under MPS. Additionally, the 
cancellation of jobs is more difficult. The difficulty increases in proportion to the 
number of terminals online, and the number of active partitions, when the mal- 
function occurred. Hands-on debugging cannot be attempted without informing 
and affecting all the terminals. 



During program testing 

Although systems may not be large or complex in this type of environment, it is 
less likely that the operator will know the programs. In this environment, the 
testing of new programs and the simulation of space flights, aircraft structures, 
traffic controls systems, etc., are carried out daily, with unpredictable results in 
most cases. Hands-on debugging can be done only by the programmer. Even 
recognizing a system malfunction is in itself difficult. Gathering the right 
information is of paramount importance, to enable the programmer to debug 
offline. 

The previous paragraphs indicate that when a system malfunction occurs, tlie 
operator must be able to recognize it as such, decide on whether or not to use 
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System Malfunctions 



hands-on debugging to make a possible recovery, and decide on the best method of 
gatliering information that will help the programmer. 

A description follows of the main types of system malfunctions, how to recognize 
them, and how to treat them. 
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Type of Malfunctions 

LOOPS 



Definition 

A loop in a program is the repetitive execution of a sequence of CPU (central 
processing unit) instructions. 

If the number of instructions in the loop is small, the loop is referred to as being 
small, short, or tight. When a loop consists of many instructions, which may also 
include input/output operations, the loop is often referred to as long. 
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Types of loops 

A part of a program may be repeated a number of times, thus creating a programmed 
loop. A programmed loop is often referred to as a processing loop. Sometimes a 
program error causes the CPU to repeat part of a program endlessly. Such a loop is 
never intended and requires debugging procedures to isolate the error. 

Recognizing a loop 

One or more of the following may indicate that a job/program is in an unintended 
loop: 

• A steady glow in the lights of the system control panel with the SYS indicator 
on. For the Model 125, one address will appear to remain displayed on the 
video display unit. (This depends on the size and nature of the loop.) 
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A rhythmic pattern in the lights on the system control panel, or for the 
Models 1 15, 125, and 158, the word WAIT may flicker on the video display 
unit . 

• A pointless recurrence of I/O (input/output) activity. 

• A job (program) that does not change status for a long time (for example, an 
absence of I/O activity). 

A note to the operator: When a loop is recognized , the operator must first try to 
establish whether the loop is unintended or has been programmed, before beginning 
with hands-on debugging. 

If the programmer has not warned the operator about a programmed loop, or given 
a time estimate for the program, it will be very difficult to differentiate between 
an unintended loop and a programmed loop. 

Even when time estimates are given, job or program time may increase because of 
any one or more of the following: 

• Priority of the partition in which the job is running (multiprogramming 
system) 

• CPU retry and error logging routines 

• The use of slower speed input/output units than those for which the job was 
originally planned. 
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Causes of an unintended loop 



A coding or logic error in the program may cause an unintended loop. 

The operator may have set the job up incorrectly, thus causing the program 
to loop at some stage during execution. 

An input/output device malfunction. 
A JCL (job control language) error. 
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Types of Malfunctions 

Operator action LOOPS 

If the operator is not sure whether the loop is unintended, the programmer must 
be contacted before any debugging procedures can begin. If this is not possible, 
the only action the operator can take is to let the job run on for a time, depending 
on system commitments, and to make notes of any further system activity. If the 
loop is programmed, no time would have been lost by allowing it to run on. In 
multiprogramming environments a loop in one partition will affect the run times 
of programs in other partitions. 

Flowcharts in Section 3 will help the operator in gathering information at the 
time the error occurs, and Section 4 provides a guide for programmers in how to 
analyze this information. 






Introduction 1 .9 



Types of Malfunctions 
WAIT STATES 



Definition 

There are occasions when an error in the program or the machine causes the 
system to stop. This means that no I/O activity is occurring and no instructions 
are being executed. 

In this state the hardware circuitry turns on the WAIT indicator, or on the 
System/370 Models 115, 125, and 1 58. displays the word WAIT on the video 
display unit, and the system is said to be in a wait state. 



Types of wait states 

The impact of a wait state on system operation depends on the cause of the wait 
and the operator action required to recover from it. The following terminology 
is used for describing a wait state: 



Hard wait 
Soft wait 
Normal wait 



Essentially, the difference between the first two waits is that the system 
recovery from a hard wait is impossible without executing a system IPL, whereas 
recovery from a soft wait may be accompUshed without impairing program or 
system operation. The operator can easily determine the type of wait state by . 
pressing the REQUEST key. If the wait is soft, the message "AR" is issued and 
the console will accept input. 



When the system is waiting for operator response to a message printed on the 
console printer or for an I/O device to be made ready by operator action, 
the wait state is sometimes referred to as normal. 
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Recognizing a Wait State 

Any of the following observations confirm that the System is in a wait state: 

• WAIT indicator remains on, or for a System/370 Models 115, 125, and 1 58, 
the word WAIT remains displayed on the video display unit. 

• SYS indicator remains off (See Figure 1-2). 

• No I/O device activity occurs. 

• One or more SYSTEM CHECK indicators are on. 

• A HARD MACHINE CHECK message is printed on the console printer. 

• A HARD WAIT coded message in general register 1 1 (X'B'). 

• A HARD WAIT coded message in bytes 0-3 of low address storage. 
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Causes of a soft wait 

A soft wait may be the result of an I/O operation performed on a malfunctioning 
device that is unable to complete an operation. 

A system waiting for a magnetic tape unit to rewind a tape reel or for a disk unit 
to finish a seek before continuing a program, is in a temporary soft wait. 



Types of Malfunctions 

WAIT STATES 
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Recovery from a soft wait 

If the system is in a soft wait, it is waiting for an interrupt to signal the completion 
of an event. Although the expected interrupt may be from the timer or external 
interrupt key, a missing "device-end" caused by hardware is the most frequent 
cause. The operator can make each device not-ready, then ready, to generate a 
device-end interrupt from each device. The system Ught flashes briefly as the 
supervisor exaniines and discards interrupts for which it was not waiting. The 
interrupt from the device for which the system is waiting causes normal processing 
to continue. (The occurrence should be brought to the attention of the customer 
engineer as a possible hardware failure.) 

It may be possible to isolate the cause of the wait and take alternative action, such 
as using a different I/O device. 

Recovery from a wait state becomes more important on large online multi- 
programming systems where to cancel programs or to re-IPL may be disastrous. 



Causes of a hard wait 

Hard waits can be caused by machine failure and programming errors. Possible 
programming errors that cause hard waits are ; 

• Supervisor errors as the result of a program check while in the supervisor 
state 

• Coding errors in transient routines 

• Incorrect use of transient routines. 



Operator action 

If the hard wait has been caused by a hard machine check shown by a message on 
SYSLOG and/or a coded message in bytes 0-3 of low address storage (see note), 
the operator must gather information from the system to help the IBM customer 
engmeer locate the error. 

If, however, there is no indication that the wait has been caused by a hard 
machine check, some information as to the cause of the wait can be obtained 
before retrying the job or starting a new one. 

In any case certain initial checks must be made on the setup procedures for the 
job, the input media in use, and I/O devices in use. 

Flowcharts in Section 3 will help operators in carrying out initial system checks 
and in gathering data about the wait state, and Section 4 provides a guide for 
programmers in how to analyze the data. 

/I ,.-'■- 
Note: Por the Models 115 and 125 that are. not supporting MCAR/CCH, a coded 

message is placed in GRll. A complete list of coded messages is given in Section 2. 
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INDICATORS FOR 
LOOPS AND 
WAIT STATES 
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The SYS, MAN, and WAIT indicators show the CPU and 
I/O operating states as follows: 
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Model dependent ?^/-s./-^,r^7-v7->; 
control console >Q) (g)(Q) (2)(9) @ 
layout BE] B 6)5058 E) 




IMDICATOR 


FUNCTION 


SYS * 


The SYSTEM indicator is on when CPU operations are 
in progress and either use meter is running. 


MAN * 


The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a stop state. All pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 


WAIT * 


The WAIT indicator is on when the system is in a wait state 
(CPU clock running but no instruction processing taking 
place). If the wait is a soft wait state and an interrupt 
occurs, the CPU is taken out of wait state and processing 
started under control of the program being executed. 



* These indicators do not exist on System/370 Models 115, 
125, and 158. Instead the corresponding words are displayed 
on the display unit. 
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MAN WAIT 


CPU State 


I/O State 


O 
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Abnormal condition 


Abnormal condition 
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Wait 


Not working 


O 
O 
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Stopped 
Stopped/Wait 


Not working 
Not working 
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Running 


Undetermined 


• 
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Wait 


Working 


• 


o • 


Running 


Working 






Stopped/Wait . 


Working 





WW WAIT STATE 



EZlLOOP 




y/// LOOP (with I/O activity). 



Legend 

O-off 



On 



Figure 1-2. System indicators. 

Aids for recognizing a loop or a wait state. 
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Types of Malfunctions 

Definition INCORRECT 

T . . . f ■ .1- . u . . OUTPUT 

Incorrect output can range from incorrect line spacing on the printed output 

from a line printer to incorrect results of calculation written on a disk file. 

Recognizing incorrect output 

Incorrect output may be detected by: 

1. Operator 
Invalid messages '] Ton console printer(s) 
Unidentified data y -1 line printer(s) 
Duplication of data J L display unit(s) 
Lack of activity on I/O devices assigned as output units 
Either more or less I/O activity than expected. 

2. Programmer 

If the execution of a program has been apparently successful, incorrect results 
will not be detected until the data is used at some future time. 
Incorrect output can be categorized as: 

• Missing records 

• Duplicate records 

• Invalid data that has sequence errors, incorrect values, format errors, or 
meaningless information. 

Causes of incorrect output 

As well as errors in the program logic, mistakes in setting up the system for the 
program will cause errors in the output. For example, use of incorrect data for 
input files, mistakes in device assignments, and incorrect job control statements and 
commands in the job stream will cause unexpected output. 

Operator action 

If the programmer cannot be contacted, the operator must save the output (what- 
ever it is) or make a note of system activity before cancelling the job, or both. 

The work files and input data should be given to the programmer together with 
any dumps executed. It may also be necessary to re-submit the job and trace the 
logic flow by using the SDAID BR and/or IF trace. 

Flowcharts in Section 3 and 4 indicate the serviceabiHty aid to use for isolating the 
cause of this type of system malfunction. 
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INTERMITTENT 
ERRORS 



Definition 

An error which occurs once and then seems not to recur for some time, is said 
to be intermittent. The frequency of the error may be a fraction of a second in 
the case of a high-speed computer like the System/370, or a week, a month, a year, 
or even longer. Intermittent errors can be caused by hardware failures or by 
programming errors. 






Hardware failures 

IBM provides serviceability aids that record and analyze hardware failures and 
attempt to recover from them. The routines that perform these functions are 
collectively termed RMS (Recovery Management Support), If online recovery is 
impossible, the system may be placed in a hard wait state. A message is issued to 
the system operator to run either the SEREP or EREP program. The output 
obtained from either of these programs is a listing of the statistical data accumu- 
lated up to and including the time of the error. This information serves not only as 
an aid in diagnosing machine errors, but also helps IBM customer engineers to 
increase the Reliability, Availability, and Serviceability (RAS) of the system. 

RMS does not affect system operation, except for the time required to record the 
failure and issue an informatory message on SYSLOG. 

• Note: By use of the MODE command the recording and printing of soft 
machine checks can be suppressed. (This is not applicable to the 
Models 115 and 125). 

If the retry of an error is not successful and the severity of the error prevents 
system operation, the machine attempts to issue the message 

OTllW HARD WAIT CODE = X (where X is an alpha character A thru I) 
and the system is placed in a hard wait state. Diagnosing this condition is described 
in Sections 2 and 3. 

On the System/370 Models 115 and 1 25 statistical data about the hardware is 
recorded on the console file by micro-program. The recorded data on the console 
file can be displayed on the video display unit by selecting one of the LOG 
ANALYSIS displays. This is described more fully in Section 2 — F in this manual. 
The information displayed supplements the EREP/SEREP program output that 
may also be required, depending on the type of I/O units attached to the systems. 
If a hard wait occurs with no message on the console printer, there may be a 
message in "low address storage" that will indicate an operator action. Low 
address storage and its meaning is fully discussed in Section 2. 
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Intermittent programming errors 

After writing a program, it is in most cases quite impossible to test it under all 
combinations of circumstances that may occur during its use. Therefore, 
programs may contain coding errors that become evident only under particular 
circumstances, even after years of error-free use. 

Since the error does not occur every time the program is executed, and the EREP 
printout or Log Analysis display indicates no hardware failures, this type of 
system malfunction is regarded as an intermittent software error. 

Such an error can be caused by a combination of the following: 
A change in the input data (a new card deck) 
Poor quality input media (cards, tape, data transmission) 
An existing coding error in a routine that is not normally executed 
A change of routines called by the supervisor 
The use of a new software routine 
New operating procedures 
Changes in the job control language. 

An error of this type is difficult to isolate, and requires the use of special 
debugging techniques. 
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Definition 

There are three types of program check interrupts: 

1 . A page translation exception. This occurs when an instruction or data is not 
in the real address area. A page from the page data set must be 'paged in' to 
the real address area before the program can continue. This is not an error 
condition. 

2. Program check interrupt resulting from the use of the MC (monitor call) 
instruction. This is not an error condition. 

3. Program check interrupt resulting from incorrect specification or use of an 
instruction or data by the problem program. This is an error condition, and is 
always reported by a message issued on SYSLOG at the time of the program 
check as shown below: 
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PROGRAM CHECK 
INTERRUPT 



BG 0S031 PROGRAM CHECK INTERRUPTION - HEX LOCATION 0406EO - 
CONDITION CODE 3 - DATA EXCEPTION 
OSOOI JOB DEBUGEXS CANCELED 

The program is automatically cancelled by the supervisor and depending on the 
use of the job control statement / / OPTION DUMP, or the DUMP option being 
supported by the supervisor, a dump of the supervisor and of the partition owning 
the program is executed. This automatic program cancellation is termed abnormal 
EOJ (end of job), or program abnormal end. The program check message gives 
the location of the failing operation and the condition code. This gives the pro- 
grammer a starting point for offline program debugging. 
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Causes of a program check 

The most probable cause is improper specification or incorrect use of instructions 
or data in the program. 

Program checks occur most frequently during program testing, because of 
incorrect coding or errors in the program logic. 



Operator action 

No action can be taken by the operator other than saving for the programmer the 
console printer log sheet, the dump (if executed), job stream, and any input 
data files used by the failing program. Flowcharts in Section 4 will help the 
programmer to analyze the information and isolate the error. 
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I/O DEVICE 
MALFUNCTIONS 



A device malfunction either will be seen immediately as an incorrect physical 
operation, or will cause the system to enter a wait state, loop, or produce 
incorrect output as already discussed. Normally an error message will be 
issued on SYSLOG. 
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Examples of device malfunctions 



Some obvious device malfunctions are: 

• Mechanical noises not normally present 

• Lamps either on or off which the operator recognizes as not normal conditions 

• A lack of movement of input/output media which the operator knows to be 
incorrect at the time 

• "Tape Runaway," a special type of error that occurs on magnetic tape drive unit 
(A mounted tape winds forwards at a higlier speed than normal.) 

• Incorrect "form skipping" on the line printer. 



Operator action 

If there is no obvious action that can be taken such as pressing the device STOP 
and/or OFF buttons, consult the device component manual before informing 
your IBM customer engineer (unless the nature of the malfunction constitutes 
a danger to human lives and equipment). 
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Gathering Information 
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When a system malfunction is recognized it is important that the operator obtains 
information from the system. The information helps the programmer and the IBM 
customer engineer during offline program debugging. Wliatever the system mal- 
function, the operator must always save error messages issued on SYSLOG and/or 
on SYSLST, and in some cases save the I/O media (card files). 

The operator can obtain information by doing one or more of the following: 

• Issue the MAP command. 

• Make a note of system activity, 

• Display low address storage, the current PSW, the control registers and 
general registers. 

• Execute a storage dump. 

• Take a trace of a loop. 

• On the Models 135, 138, 145, 148, 155-11, and 158, initiate the ERE? 
or SERE? programs 

• On the Models 115 and 1 25 on the advice of the IBM CE use the Log 
Analysis to display hardware errors recorded on the console file, 

' and on the Model 158 use the display frames. 

Many factors must be considered when gathering information, and Section 3 and 4 
cover this subject in detail. 
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Gathering Information 



LOW ADDRESS 
STORAGE 



This area of low real storage (as defined in the Introduction to DOS/VS) is one of 
the important sources of system information used to aid offline program debugging. 
The contents of the low address storage can be dumped (printed out) or displayed 
by using job control commands or console aids. Details about the format and 
contents of the low address storage are given in Section 2-E of this manual. 
Figure 1-3 illustrates the location of low address storage in relation to other areas 
in virtual storage. 
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HIGH ADDRESS STORAGE 






Figure 1-3. Relative location of low address storage. 

Low address storage contains information to aid offline debugging. 
(Size relationships in this figure are purely illustrative.) 
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A dump is a program or an operation that prints the image, in hexadecimal format, 
of a selected area of virtual storage. This term is also used when an area of virtual 
storage is recorded or stored on magnetic tape or on a disk pack. 



STORAGE 
DUMPS 



Figure 1 - 4 illustrates the various type of dumps offered by IBM. Section 2 - A of 
this manual describes how to execute the dump programs and operations, and 
discusses the meaning of dump output that is useful during offline program 
debugging. 
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, SHARED VIRTUAL AREA 



A dump or display of the 
low address storage. 

Attention routine commands 
and operator's console. 



A dump of a partition in the 
real or virtual address area. 
This is referred to as a 

Partition dump or a System 
dump and includes a dump of 
the supervisor area. 

System generation option, 
job control statement, fob 
control command, and 
assembly language macros. 



A snap shot dump used to 
display small parts of a 
program at any selected 
area. 

Attention routine commands and 
assembly language macros. 



A dump of the SVA 

Partition dump or a System 
dump includes a dump of 
the SVA (or part of it) if 
a program check occurs 
in the SVA. 



Figure 1 - 4, Storage dumps. 

Various areas of storage can be dumped or displayed using the IBM dump 
programs and console aids. 

(The dividing point between real and virtual address areas depends on the size 
of the hardware memory on your System/370). 
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LOOP TRACING 



Three methods of tracing or recording the path of a loop are provided on the 
System/370: 

1 . By using the facilities provided by the operator's console, the operator can 
list the addresses of the instructions used by the loop, 

2. By using the successful branch routine of the SDAIDS. 

3. By using the instruction fetch trace of the SDAIDS. 

All three methods are described in Section 2. The first method is useful to trace 
small loops during hands-on debugging. However, the amount of time that may be 
spent tracing a loop by this method depends on the ansv^^er to the following: 

1 . How important is it to system operation that the loop be fully traced? 

2. How will the time spent tracing the loop affect system commitments? 
Normally the operator is not in a position to answer these questions and if the 
programmer or the DP manager is not available he can only take a short trace. 
The second and third methods can be used either during hands-on debugging, or 
during re-runs of the program generating the loop. 



A note to operators 

Before tracing a loop by using any of the above methods, you must consider their 
effects on time-dependent programs currently running in the system,. Such 
programs are, for example, those using magnetic ink character recognition or 
teleprocessing equipment as input/output devices. 

Guidelines on how to isolate an unintended loop and trace it are given in 
flowcharts in Sections 2 and 3. 
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RMS (Recovery Management Support) 

The functions employed in recording a hardware error and recovering from it are 
doUectively termed RMS (Recovery Management Support). RMS was introduced 
under "Hardware failures" in this Section. RMS software routines record hardware 
failures on the system recorder file, located on SYSREC (SYSREC can be either 
an area on SYSRES, or an individual disk pack.) 

For the System/ 370 Models 1 15 and 125, errors in the CPU and natively attached 
input/output devices (except tape units and teleprocessing terminals), are recorded 
on the console file. Recording is performed by microprograms and is independent 
of the RMS software routines. 

Figure 1-5 contains an overview of RMS, which is a part of the total RAS 
(Reliability, Availability, and Serviceability) concept. RMS uses a monitor and 
several transient routines that check the severity of the error, record it (if possible), 
and print informatory messages. 

Using an IBM program called EREP (Environmental Recording, Editing, and 
Printing) the data on the recorder file can be printed on a line printer. This data 
is used to investigate the nature and cause of a system malfunction. For the 
Models 1 15 and 125 , information will be printed by EREP only if the system 
supports RMS. (Refer to Section 2-F for details.) 

If the severity of a hardware error is such that EREP can not be executed, the IBM- 
supplied program SEREP must be executed. SER^EP is a stand-alone version of 
EREP that formats and prints the data held in the logout areas of real storage. 

On the System/370 Models 1 15 and 125, the LOG ANALYSIS displays hardware 
statistical data recorded on the console file. This is additional to the EREP program 

that can be executed after using the log analysis displays. 

A similar facility is provided on the Model 158 in the form of display frames obtained 
by the use of the SERVICE function. 

How to execute EREP and SEREP, and how to use the log analysis displays and 
display frames feature is described in Section 2. The components of RMS are fully 
described in Section 2-F. 
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Hardware error 



Error detection, correction, and 
recovery by hardware microprogram 



IVIachine checl< interrupt 
generated for CPU error, 
main storage and control 
storage errors. 



I/O interrupt generated 
for I/O channel and device 
errors. 




For System/370, Model 1 1 5/1 25 
record error on the console file. 
Log error in the LOGOUT areas 
of real storage. 



RMS 
Software -i 
Routines 



Re-analyze 
data about 
the error. 



Automatic system action 



Records data about the 
error on the system 
recorder file. 



• Prints a message on SYS LOG 
to inform operator that a 
hardware error has occurred. 

• Continues normal processing. 



No 



Automatic System Action 
(depends on severity of error) 




Saves data about the error 

in registers 

Continues processing in a 

degraded mode 

On Models 115/125/158 

recording on the console 

file occurs 



Automatic system action 



Tries to record data about the 
error on system recorder file. 



Tries to print a message on 
SYS LOG to inform operator 
about the type of error. 
Places system in a hard wait. 



Automatic system action 




Records data about the error 
on the system recorder file. 



Cancels the job in which 

the error occurred. 

Prints a message on SYS LOG 

to inform the operator of 

system action. 

Continues processing with 

next job. 



Operator action 



For use by IBM 
customer engineers 
during scheduled 
maintenance 
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For System/370, Models 115 and 
125, use the LOG ANALYSIS 
feature to display hardware 
statistical data and for Model 158 
use the display frames 



Figure 1-5. An overview of RMS, 

This illustration shows the general connection 
between the hardware and software components of the 
hardware error recording and recovery functions. It 
also shows the connection between RMS and the 
EREP and LOG ANALYSIS programs. 



f 



± 



Use EREP to print out 
the data about hardware 
errors recorded on the 
system recorder file. 



Programmer action 
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IBM customer engineer's action 



Use the EREP printout to 
find out more about the 
system. 



Use EREP printouts to aid 
in hardware error diagnosis. 
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EREP (Environmental Recording, Editing, and Printing) 

This program edits and prints information about hardware failures that are 
recorded on the system recorder file (SYSREC). 

There are several options of EREP that enable the operator to select SYSREC 
records for editing and printing. These options are detailed in Section 2. By using 
the EREP program output, the IBM customer engineer can recognize hardware 
failures. During scheduled maintenance periods he can then perform preventive 
maintenance on the parts of the system causing hardware failures. 

Because the EREP program can be initiated by the operator, it is a useful aid for 
gathering data about the condition of the hardware at any time during 
system operation. 

Some messages issued on SYSLOG tell the operator when to execute EREP. 
For example: 

0T1 1W HARD WAIT CODE = D 

RUN EREP RECORDING SUCCESSFUL 

Other occasions when EREP should be executed are indicated in DOS/ VS 

Messages. 

For example: 

0T05E ERROR ON RECORDER FILE - RUN EREP 
Operator action: 
Schedule the EREP program to display the information on SYSREC . 

Either the operator action Hsted under the appropriate message -will indicate 
the EREP option to select, or your IBM customer engineer will advise you on the 
option to select. 

Flowcharts in Sections 3 and 4 also indicate when to execute EREP. 
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SEREP (Stand-alone EREP) 

This is a stand-alone program that edits and prints hardware failure data either 
stored in the logout area of real storage or, for the Model 158, recorded on the log 
recording console file. 

SEREP provides a means of printing system status information stored in the real 
storage logout areas at the time of the machine malfunction. The SEREP 
printout is analyzed by your IBM customer engineer. 

For the Models 135, 138, 145, 148, and 155-11, SEREP is initiated using the 
standard IPL procedure. The SEREP program consists of a card deck and must 
be executed when the message issued on SYSLOG indicates "RUN SEREP" 
For example: 

on 1W HARD WAIT CODE = H 

RUN SEREP RECORDING UNSUCCESSFUL 

For the model 158 SEREP is contained on the Log Recording Console File which 
is loaded by using the Service and Index frames. 

If a hard wait condition occurs and no message is printed, a wait message in low 
address storage will inform the operator if SEREP is to be initiated. 

Flowcharts in Sections 2 and 3 indicate how and when to use SEREP. 
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Log Analysis Displays (Models 1 1 5 and 1 25) 

This aid, provided for IBM CE use, enables the condition of the internal hardware 
to be displayed, and, if required for offline analysis, to be printed on the 521 3 
printer, if attached. On advice from the CE, an operator is able to obtain "hard 
copies" of the displays if a hardware error is the cause of a system malfunction. 

Maintenance (M) 

When the mode selection display is on the video screen and the operator enters 

selector character 'M' against 'Mode Specification,' the screen displays the 

maintenance repertoire. This repertoire consists of log analysis, micro tests, and 

CE manual operations, as shown in the figure below. The cursor is positioned next 

to the preselected 'M' so that any one of the maintenance modes can be 

selected. 
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1 


= CHANG. DISKETTE 


= 
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z = 


MATRIX M 



PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 




Note: E = ICA is displayed only when the system supports the Integrated 
Communications Adapter 

Figure 1-6. Model 125 maintenance program selection display. 

On the Model 115 the entry K = 3203/5203 

Log Analysis (A-E) 

When a parameter 'A' through 'E' is entered into the maintenance display, log 
information is brought to the screen. Entering 'A' for instance, causes a display of 
general log information that informs the operator if any logging occurred, and if 
so, which part of the system caused it. From this report, the operator can select 
a detailed log by keying in one of the four characters 'B' through 'E'. For example, 
'B' provides log information for the CPU. 

A "hard copy" printout of the displayed information can be obtained and saved 
for your IBM customer engineer by pressing the copy key, if a 5213 matrix printer 
is attached to your system. 

Further details are given in Section 2, F-5. 
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Display Frames (Model 158 only) 

A serviceability aid provided on the Model 158 allows the operator to display and 
obtain "hard copies" (on the 3213 printer) of the condition of the hardware. 

The information displayed or printed is used by the IBM CE to diagnose the cause 
of a permanent hardware error. A hardware error of this type will be recognised 
by the operator by an error message displayed on the program frame, for example 
the words STOR CHECK displayed in the lower right corner of the frames. 

Having recognized the existence of a hardware error, the operator can either inform 
the IBM CE immediately, or can "look at the hardware" by scanning the information 
on the display frames and obtaining a "hard copy" of them if desired. 

The type of information displayed is listed under numbers 6 to 2§ in the INDEX 
frame shown below. 






CTRL SrORf DISPLAY 



CHAMNEL DISI'LAY 



>a CHANNL L CHtCKS? 



-CHANNLL TO CHANNEL 
-EXLCUTION ARRAY 






COMPOSE - "START •STOP 



Figure 1-7. The Model 158 Index Frame 

This frame is obtained via the manual and service frames. With this additional information 
about the hardware, the.IBM CE will be able to advise on further system operation. 
How to use this serviceability aid is described in Section 2-F. 
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Further Error Isolation 






If the error cannot be isolated by analyzing the information obtained from the 
procedures already mentioned, other programs and tools must be employed during 
program reruns. 



Trace routines 

The trace routines supplied by IBM are special programs that "look inside" the 
central processing unit during system operation. 

Traces of program execution are especially valuable on the larger multiprogramming ^ x v I j 

systems. '^ 

Traces can indicate the phases used, the supervisor calls required, the types of 
interrupts encountered, and the I/O activity during program execution. Trace 
routines can also indicate paging activity and successful branching, and produce a 
printout of instructions fetched, and storage and general register alterations, 
during program execution. 



Supervisor a>mmunication macros 

Certain DOS/VS macros can be written into programs to provide more information 
about the state of the system at the time of an error. One such macro is PDUMP, 
which will give a dump of any specified real or victual address area. 



Operator's console 

A useful tool for hands-on debugging is the operator's console. This is used for 
"tracing a loop" and displaying or altering registers and small areas of storage. 



Library and Service programs 

DOS/VS library and service programs are useful when information is required 
about previously written programs that are used by problem programs. These 
DOS/VS programs will list volume directories, print listings of the programs 
contained in the libraries, and display file label information. Such information 
is required, for instance if a particular phase on a private core image library causes 
incorrect results of calculations when used by one of the tested problem programs. 



VSAiVI Programming Aids 

VSAM (Virtual Storage Access Method) provides aids that print, list, and 
verify data recorded on VSAM files. Assembler macro instructions for VSAM 
are also provided to allow the programmer to obtain information about I/O 
operations (OPEN, GET, PUT, CLOSE) during execution of VSAM programs. 
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The analysis to be made depends on when the job failed and how much pertinent 
information the operator obtained from the system at the time of failure. It also 
depends a great deal on the system environment. The first step is to examine 
messages printed on the console log sheet, and to look for any messages on the 
output printer. 

The next step is to examine any other printed output, for instance, program output 
and storage dumps. 

For a successful analysis, the programmer, who should be familiar with the 
program, will require: 

• The program listings 

• The linkage editor map 

• Flowcharts of the failing program. 

In the more difficult cases of program errors, the programmer will also require: 

• The supervisor listing 

• Output of the trace routines 

• Dumps of the data input files 

• The input media 

• Listings (or displays) of file label information 

• Listings (or displays) of the libraries. 

If the program failure was caused by a hard wait, the programmer should scan the 
EREP printout (if one was obtained) to eliminate any possibihty of a hardware 
failure, and examine the stand-alone dump. 

Section 4 describes in detail how to use the above listed output during offline 
debugging. 
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SECTION 2 



^ SERVICEABILITY AIDS 



Serviceability Aids 2 . 1 



Section 2 

SERVICEABILITY AIDS 



How to use this section. 

Familiarize yourself with the contents of this section, which gives details about 
the operation and execution of the serviceability aids offered by IBM, 

The reference chart shown on the opposite page lists the aids described in this 
section in groups according to type. 

All right-hand pages in this section have running-tabs numbered to correspond to 
this chart. The chart helps you to locate details about any aid described in this 
section. 

For example: 

SERE? is described on page marked F — 4 

Another example: 

When a dump of the low address storage is required in an operators flowchart of 

Section 2 and 3 it is indicated as: 



Dump, or display and tiote the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 138, 145, 
148, 155-11 

and D-2-F for Models 1 1 5, 1 25 
and D-3-Ffor Model 158 



D-l-F, D-2-F and D-3-F refer to tab numbers that identify unique pages in this 
section. 

In this example it guides the operator to the flowchart procedure for dumping 
low address storage. 
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Table referencing in this Section 

Illustrations in this Section do not have figure numbers, but are referenced by the 
text. For example, "the next illustration shows. . . . ." or "the figure on the 
opposite page shows the ". 

However, because tables in this section are often referenced from other parts 
of this manual the tab referencing system is used for the Tables. For example: 
A table in subsection B-6 is given the reference of B-6. If there is more than 
one table in any sub-section the first table is given the reference B-6-A and the 
second table B-6-B, and so on. 
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Other aids 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(ALTER) 



The ALTER Command 

To activate the ALTER command press the REQUEST key and enter ALTER. The 
command is used to alter from 1 to 16 bytes of virtual storage starting at the 
specified address. 



c 



Operation 


Operand 


ALTER 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command has been entered and the END key pressed, the hexadecimal 
representation of the information to be placed in storage should be entered. Two 
hexadecimal characters (0 to F) must be entered for each byte to be changed. 
If an odd number of characters is entered, the last character is ignored and its 
associated byte is unaltered. 

Examples are shown below. 
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Dumps of, and changes to Real and Virtual Address Areas 

Restrictions OPERATOR COMMANDS 

1. If the bytes to be altered cross the boundary from a valid to an invalid address (AL I t R; 
space (see the third restriction, below), only the bytes in the valid address 

space are changed, and the following message is issued on SYSLOG: 

11471 XX BYTES COULD ONLY BE ALTERED 

2. If the highest available virtual storage address is exceeded before sixteen 
bytes are printed, the command is terminated and no alteration can occur. 

3. If the specified address is within an invalid address space, message 

1141D INVALID ADDRESS 

is issued on SYSLOG. 

An INVALID ADDRESS is one of the following: 

• The address of a location beyond the end of virtual storage. 

• The address of a location in the page pool. 

• The address of a location in a virtual partition whose real partition 
contains a program running in real mode. 

• The address of a location in the non -addressable part of the real address area 
(if RSIZE is specified larger than the CPU storage size). 

4. Altering the Supervisor area or SVA 

If the address entered falls within the supervisor area or within the shared virtual 
area (SVA), a warning message is issued on SYSLOG: 

1I42D ADDRESS WITHIN SUPERVISOR OR SVA 

To respond to this message, press END/ENTER to terminate the ALTER 
command or reply with IGNORE to allow alteration. 

When to use 

This aid is primarily a hands-on debugging aid. The programmer can use it in 
conjunction with program listings to modify any part of the programs presently 
running in virtual storage. This enables immediate checks on results of 
program changes during execution of the program. 
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Dumps of, and changes to Real and Virtual Address Areas 



OPERATOR COMMANDS 
(DSPLY) 



The DISPLAY Command 

To activate the DSPLY command press the REQUEST key and enter DSPLY. The 
command allows the operator to display on the console printer keyboard 16 bytes 
of virtual storage starting at the specified hexadecimal address. Two hexadecimal 
characters (0 to F) are printed for each byte of information; these characters 
represent the hexadecimal equivalent of the current information in the virtual 
storage. 






Operation 


Operand 


DSPLY 


xxxxxx 



The operand xxxxxx is a six-digit hexadecimal address. Six digits must be 
entered regardless of the size of the address; addresses of less than six digits must 
be preceded by zeros. 

After the command is entered and the END/ENTER key is pressed, the hexadecimal 
representation (two characters for each byte) of sixteen bytes of virtual storage 
will be printed. 

Examples are shown below. 
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Dumps of, and changes to Real and Virtual Address Areas 

OPERATOR COMMANDS 
Restrictions (DSPLY) 

1 . If the sixteen bytes cross the boundary from a valid to an invalid address space 
(see the third restriction, below) only the bytes in the valid address space are 
displayed, and the following message is issued on SYSLOG: 

11481 XX BYTES COULD ONLY BE DISPLAYED 

2. If the highest available virtual storage address is exceeded before sixteen bytes 
are printed, the command is terminated. However, the contehts of those 
bytes that fall within the virtual address area are printed. 

3. If the specified address is within an invalid address space the following message 
is issued on SYSLOG: 

1I41D INVALID ADDRESS 

The definition of invaUd address space is listed under item three of "Restrictions" 
in the description of the ALTER command. 

When to use 

This aid can be used during hands-on debugging, or an operator can be 
instructed to use it at specific addresses in a program. 

For instance, loop count areas, small areas modified by loops, or parts of I/O 
areas can be dumped or displayed during program execution. The dump 
information will help during offline program debugging. 
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OPERATOR COMMANDS 
(DUMP) 



The DUMP Command 

To activate the DUMP command, press the REQUEST key and enter DUMP. The 

command allows the operator to display large areas of virtual storage on SYSLST. 

The SYSLST used may be assigned to any partition, but it must be a printer and it 

should not be in use by the partition. If the same printer is being used by the 

partition, the printed output will be a mixture of dump and partition output. 

If SYSLIST is assigned to a 32 1 1 printer and the printer's indexing feature 

is being used, a certain number of characters may get lost on each line of 

the dump. To avoid this, the operator should load a new FCB (forms control buffer) 

image to disable the indexing feature before he issues the DUMP command. 

The new FCB image can be loaded either by issuing an LFCB command 

or by executing the SYSBUFLD program. 



c 



Operation 


Operand 


DUMP 




'S 
BG 




"(BG) " 
(Fn) 


Note 1 






Fn 










BGS 










FnS 










PDAREA 










_ address, address 







Where n can have a value of 1 through the highest foreground partition available in the system. 



If the first operand is omitted, the general registers, control registers, and all storage that 
is currently used by programs, except that used by the supervisor will be dumped. See note 2. 
The storage used consists of: 

• Real storage not belonging to the page pool 

• The virtual partitions in which a program is currently running 

Description of the operands: 



Operand 


Meaning 


S 


Causes a dump of storage used and the supervisor area. See note 2 


rsGi 

LFnJ 


Causes a dump of the specified partition and its associated registers. 
If a real-mode program is running in the specified partition, the temporary 
real partition is dumped. If a virtual-mode program is executed in the 
specified partition, the whole virtual partition is dumped. 


Fbgs" 

[jFnS_ 




Causes a dump of the same areas as described for the BG/Fn operand. 
However, the dump will include the supervisor area. 


PDAREA 


The registers, PD table, PD area, and the alternate address area, if present, will 
be dumped. (See Section 2, B-3 for details and a description of the PD area.) 


address, 
address. 


Specifies the hexadecimal starting and ending addresses of virtual storage, 
with associated registers, that is to be printed. If the starting address is not 
on a fullword boundary, the address is rounded down to the first fullword 
boundary; if the ending address is not on a fullword boundary, the 
address is rounded up to the first fullword boundary. A minimum of one 
fullword is dumped, beginning at the start address. 



Notes: 1. 



BG\ I '^^" ^"y °^ these additional operands are specified, the area of virtual storage 
Fn ) I specified by the first operand is dumped on the SYSLST assigned to the partition 
M specified by this operand. SYSLST must be a printer and should not be in use by its 
M assigned partition. If the same printer is being used by the partition, the printed output 
I I will be a mixture of dump and partition output. There must be no intervening blank 
\ between the two operands. 
(If this operand is not specified, the SYSLST printer assigned to BG is used. See note 2.) 
2. 

An indication is given on the dump output whether the dump includes storage areas considered 
to be invalid address spaces. The definition of invalid address spaces is listed under item 
three of Restrictions in the description of the AL TER command. 
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When to use 



This command is useful in circumstances similar to those described for the 
DSPLY command: to obtain information about I/O areas, or areas modified by 
loops or transients during program execution. The only difference between this 
command and DSPLY is in the size of the area that can be dumped. 



Note on execution of DUMP: 

1. Logical transient routines cannot be checked because the LTA is used by 
the DUMP transient. The information in the LTA is thus overwritten by 
the DUMP routine. 

2. The system will be seized by the DUMP transient for the duration of the 
dump. 

3. Output from the DUMP command will not be spooled by POWER/ VS. 



The example below shows part of a dump of the PD area using the DUMP 
command, when SYSLST ist assigned to a Une printer. 



OPERATOR COMMANDS 
(DUMP) 




o 



CR 0-7 
t\ 8-F 

PO&RE& 

• 009*80 
OO^'VtO 

« 0094CO 
^ 009*E0 

009 500 
H 009520 
^ 0095'fO 

009560 
a 09580 
^ C095A0 

O095CO 
^ 0095EO 
^ 009600 

009620 
^ 009640 
^ 009 660 

009680 
^ 009 6&0 
^ 0096CO 

0096EO 
|k 009700 

• 009720 
009740 

^ 009760 

• 009780 
009 7A0 

^ 009 7C0 
^ 009760 

009800 
^ 009820 
^ 009840 

009860 
^ 009880 
^ 0098&0 

009 8C0 
^ 003 8E0 
^ 009900 

00992 
A 009940 

• 009 960 
009980 

^ 0099&0 

^ 009 9C0 

0099E0 


804a00E0 
00005 300 

E3D37EF3 
00000000 
FFFFFFFF 
FFFFF=80 
50C091C4 
47F09084 
00004111 
58B10020 
B0034rF0 
078*070* 
078A5501 
918807=* 
001842*3 
47F09110 
00009666 
8*FD3900 
8*F00000 
20000000 
OO0EO70C 
04000000 

00008*= a 

FF008*FO 
070= J 000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
OOOE070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08003000 
00000000 
00000962 
070:2 000 
0000:240 
8&F00800 
8AF00000 


0000F6OO 
00000000 

F8F07000 
00004798 
FFFFFFFF 
800047AE 
58*00014 
95FF*002 
00005 SCO 
19AB4740 
910CBFB7 
49209038 
B00691C8 
58B091B8 
0002943 
58A1001C 
000099FC 
OOOOOOOE 
00000400 
096 20000 
20000000 
E 2 400000 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF 00800 
8AF 00000 
20000000 
000E070C 
04000000 
00008AF0 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
00OEO70F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 


FFFFFFFF 
000000 00 

000099FF 
00003AA4 
FFFFFFFF 
47F0915C 
48AOA040 
478D910C 
91C49120 
90FE41CB 
BD454770 
078A070A 
O78A58B0 
44009068 
80029120 
50A80O0S 
C4E4D400 
O70F200O 
OOOOOOOE 
000004 00 
09620000 
OOOEFFOO 
OO0EO70F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
000004 00 
09620000 
20000000 
E240OO0O 
08000000 
00000000 
00000962 
070C2000 
0000E240 
8AF00800 
8AF0OO00 
20000000 
000E070C 
04000000 
00008AFO 
FF008AFO 
07 OF 2000 
OOOOOOOE 


FFFFFFFF 
00030300 

0000479C 
00031330 
3FDEFFFF 
58B091BB 
492A0000 
1BCC43CA 
100647E0 
004819AC 
JOO:D732 
4920903A 
91B841B6 
502B0302 
10064710 
9133B332 
30002330 
30300962 
070C2000 
0OOOE24O 
BAFOOBOO 
BAF003OO 
20000300 
OOOE070C 
04000000 
00008AFO 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09620330 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
0003030E 
00000400 
09620000 
20000300 
E2400000 
08000000 
00000300 
00000962 
370C2000 


00000000 
00300000 

30301S3E 

D7:4ci:9 

FFFFFFFF 
D20FB002 
4780909C 
033239:o 
910C50CO 
472090FE 
B33BB33B 
078A58B0 
001259B0 
501B0036 
913C9130 
47809192 
D5E7FFFF 
30300030 
00000962 
0000003E 
0000003E 
00300430 
09620000 
20000000 
E2400030 
08000 000 
00000030 
00000952 
070C2030 
a000E240 
6AF00800 
8AF00000 
20003000 
OOOE070C 
04000000 
30308AFO 
FF008AFO 
070F2000 
OOOOOOOE 
00000400 
09S20000 
OOOEFFOO 
DO0EO7OF 
04303000 

ooodoooo 

00000952 


00000000 
00000000 

0000 B44E 
C4C9E3E6 
FFFFFFFF 
00380201 
95FFA000 
000358A3 
91C41BAA 
1BAB5AAB 
58C091C4 
008058B0 
91BC4743 
0201 BOOO 
80024773 
47F090CA 
000E070C 
04000003 
00008AF0 
FF008AF0 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
000E070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 
00000000 
00000962 
O7OC2000 
O00OE24O 
BAFOOBOO 
8AFOOO00 
20000000 
000EO70C 
04000000 
00008AFO 


00003000 
C2300000 

0OOO0C56 
FFFF0009 
FFFFFFFF 
BOOOOOBA 
4780910C 
00805AC0 
BFA73041 
003C58B0 
58A09O5C 
B01C350? 
91565883 
91B050A0 
91100702 
E2400000 
20000000 
E2400000 
08000000 
30003000 
00300962 
070C2000 
0OOOE24O 
8AF00800 
SAFOOOOO 
20000000 
OOOE370C 
04000000 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00003400 
09620000 
OOOEFFOO 
OOOE070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09620000 
20000000 
E2400000 
08000000 


00000000 
00000200 

00009F02 
FFFFFFFF 
FFFFFFFF 
50*0905: 
41**0008 
A0245B1: 
47809110 
91B8BEA7 
49209036 
B00391CO 
91B450BQ 
9O5C88A0 
BOOB BOOB 
00009654 
09620000 
OOOEFFOO 
000EO7OF 
04000000 
OOOOOOOO 
00000962 
OOOOOOOE 
OOOOOOOE 
0000 0400 
09^20000 
20000000 
E 240 0000 
08000000 
OOOOOOOO 
00000962 
070: 2000 
O00OE24O 
8AF00800 
8*F00000 
20000000 
OOOE070C 
04000000 
00008AFO 
FF008AF0 
070F2000 
OOOOOOOE 
00000400 
09620000 
OOOEFFOO 
OOOOOOOO 


TL.380.... ...... 






POAIOITH... 


0.*.... 

#..0...... . .... 


K.....K »..* 
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The example below shows the beginning of a dump of the BG partition using 
the command DUMP BG when SYSLST is assigned to a line printer. 
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SYSTEM DUMP 



//OPTION DUMP statement 

If this statement is included in the job stream a dump of the partition, the supervisor 
and/or the SVA will be printed on SYSLST, whenever a program is canceled either by 
the operator or by other cancel conditions. The dump includes a printout of the 
supervisor area, and if the program check is within the SVA, a dump of the SVA or 
parts of it. For this reason the dump is often referred to as a SYSTEM DUMP. 

Note: There is no need to insert the // OPTION DUMP statement in a job stream if 
the default option of the DUMP parameter has been specified in the STDJC macro 
during system generation. If, however, the dump is not required when abnormal 
termination occurs during execution of a particular job, the // OPTION NODUMP 
statement must be included in the job stream. 

To enable the // OPTION DUMP statement to operate, one of two types of system 
dumps must be cataloged into your system during system generation: 

• A standard system dump, whose printed output is in hexadecimal code 

• A translating system dump, whose output is printed in hexadecimal and 
alphameric codes. 

The dump output includes the following: 

• General registers 

• Floating point registers, if FP is specified for the system 

• Control registers 

• Active communication region address (See Section 4 for a description) 

• Supervisor (see note below) 

• PD area, if PD is specified for the system (see B-3 in this section for details) 

• Label length 

• Partition identifier: BG, Fl, F2, etc. 

• Temporary real or virtual partition. 

• The Shared Virtual Area (See note 2 below). 

Note 1 : The LTA (Logical Transient Area) is used to contain the dump program. 
Therefore, the LTA printed in the dump will always contain the B-transients 
$$BDMPBC (if the dump is directed to a line printed or tape unit) or $$BDMPDC 
(if the dump is directed to a disk). 

Note 2: If a program check occurs in the SVA before the dump logical transients 
are loaded and have control, a dump of the SVA is executed. Even if the program 
check occurs in a phase within the SVA, the phase name of which has been deleted 
from the SDL (System Directory List) before the dump transients have control, 
parts of the SVA are dumped that contain the phase in which the program check 
occurred. If the SDL is not active when the DUMP is started, the system 
GETVIS area is dumped. 

When to use 

Insert this statement into job streams for new, modified, or untested programs. 
The partition dump and general register dump can be analyzed and the 
information obtained will help during offline program debugging, 

// OPTION PARTDUMP statement 



Kj 
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Tliis statement will have the same effect as the // OPTION DUMP statement, 
except that the supervisor will not be dumped in its entirety. Of the active 
communication region address, the supervisor, and the PD area, only the 
addresses and contents of the following supervisor control blocks will be 
printed: 



o 



Dumps of, and changes to Real and Virtual Address Areas 

— partition communication region SYSTEM DUMP 

— PUB table 

- PUBOWNER table 

- partition LUB table 

- JIB table 

— partition DIB table 

Other information printed is the same as with the // OPTION DUMP statement. 

Note: The PARTDUMP option can be specified during system generation in 
the STDJC macro (DUMP=PART). 

When to use 

If you do not need the entire contents of the supervisor, use this statement 
instead of// OPTION DUMP. 

How to use the dump output 

Begin the analysis by examining the error message issued on SYSLOG and/or on 
SYSLST. If the program check occurred within the SVA, the message 

PART OF SVA WHICH CAUSES THE ERROR 

is printed after the dump of the partition in which the program is running, or if the 
entire program is running in the SVA, the message is printed after the dump of the 
program save area. A hexadecimal dump, including storage of the SVA, or a dump 
of the phase running in the SVA addresses in which the program check occurred — 
follows the message. 

The example below illustrates how to use the system dump in conjunction with 
program listings and the linkage editor map in order to isolate a data exception 
program check occurring in a program running in a BGV partition. 

Step 1 : Check for messages on SYSLOG and/or SYSLST. From the message obtain the address at which the 
interrupt occurred and reason for the program check. 





r 


0S03I PROGRM CHECK INTERRUPTION - 
OSOOI JOB BUGPRGCK CANCELED 


- HEX LOCATION 0*0712 


- CONDITION CODE 3 - 


DATA EXCEPTION 


CCMSa/J^M 







Step 2: Locate the register values printed at the beginning of the system dump. Scan the contents of register 
for unreasonable values. (This may help in later problem analysis.) 




00000000 O0Od^4A^ 40000000 00000000 ....... 

00000000 00000(^ 470C2000 0000090C K 

FB61C700 023E32CD 440COOOO O0O0OC14 ..X ..X /G.... 

04080000 0000013A 440C0OOO 00000810 ......Y. ......J......... 

12042003 00020000 00000000 00000 ICC 

00000000 00000100 OOOOOOOE 00000000 

00000000 00000000 C2E4C7D7 09C7C3D2 12/06/73..... ..^BUGPRGCKJ 

OOOBFFFF FD7FCED3 38A0CED0 002E40FO 

F2F0F6F7 F3F3F4F0 00003CD4 0QC0003C 1 20673340.. .M.... 

00008090 00007118 00003864 39D45A30 '^" (£x 6 MTA 
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SYSTEM DUMP 

Step 3: Locate the linkage editor map and obtain the relocation factor. Subtract this value from the address 
given in the program check me ssa^. 

In case of a program check in the SVA, the relocation factor applicable is obtained as follows: 

1. Subtract the instruction address printed in the program check message from the first address 
printed in the dump of the SVA. 

2. Add the result to the start address printed in the assembly listing for the program or phase causing 
the error. 



c 




Step 4: Locate the resulting address (from step 3) in the program Usting. This will give the failing instruction. 




Step 5: Compare the hexadecimal code for the instruction in the program Usting with the code in the dump. 
It should be the same. 



i-r' 



V 



040660 

|^ 0406*0 
0406C0 
O406E0 
040700 
040720 
040740 



47F0B2C2 4780B302 95E0B985 4T80B75C 

ftanrKBE ^Fon^^ftOA 4F*Qr.60l= 1A561A57 
001005EF 95D7C8^P l| I HWII \\ ('i,4>8^0CDB2 
58A0CDB2 D203C672 BBD2DE03 

CE105810 COAE58FI 001045EF 000CD203 

D203C682 BB02D203 C686BBD2 0203C68A 

C67EC5FC DE03C682 C604DE03 C686C60C 

CE29D202 B94DC677 02088952 CDEED202 



47F0B24C 4ES0C5E6 4E60C5EE 4E70C5F6 
1AS84E50 C6165810 CDAE410C O01BS8F1 
5860C082 5870CDB2 5880CDB2 SM 
0283B936 B935D203 B951Cfr>r"fl5l5B938 
I^BD2 P203C67A>jft ggD203 C67EBB02 
BBD2 bE03 C676C5ECI DE03C67A C5F4DE03 
DE03C68A C614D283 B936B935 D212B93B 
B95DC67B 0210B962 CDqED202 B972C67F 



a... 






Step 6: Locate the location in the program listing that defines the data area used by the failing instruction. Use the 
relocation factor from the linkage editor map to calculate the address of the data area in the dump. 




Step 7: Locate the data area 'used by the instruction in the dump. Check if the data is specified for the failing 
instruction. If it is not, continue by identifying the point in the program listing at which the data 
is prepared. 



\>t^\ 



041600 
041620 



E2E5C340 OSC5E640 S0000048 92201004 
00609240 108OOC07 10785000 F 3841081 
9C004gflO 9D004000 47303048 



041A4D >4770303C 
<64166Q) (OOOOOOOO 
OVtMTD OOOOOOOO 00000' 



0416A0 
0416C0 
0416E0 
041700 
041720 
041740 



OOOOOf E91 OOOOOOOO 0000004C 

OOOOOOOO 0000068C 
F3841078 OOF / / 
40009000 40C *• 7' 

S0000048 47FUJUII C5Db04EZ 4040FZF6 

40202120 40202120 D306DSC4 D60S4040 

17800000 84000COO 00040004 17800004 
090417A4 60000020 090417C4 600O0O2F 



47F0301C 40404040 40404040 F3841078 SVC NEM C i .0.. 3... 

00649240 10890C07 10815000 90004000 .- <C.3 G... . 

47F01010 40404040 40404040 40404040 0.. 

OOOOOOOO OOOOOIOC OOOOOOOO 0000004C I 

OOOOOOOO 0000026C 8004033C 92601004 >/ ^ >— 

090417F3 6000001F 09041812 60000021 ....- O-... .,.^- £x MM 
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DUMPGEN 



The IBM program DUMPGEN allows you to generate a stand-alone dump program 
(REAL DUMP) that must be used to obtain information about the system under 
certain conditions of system malfunction. 

The dump consists of a printout of real storage (except bytes X'00'-X'17', X'40'- 
X'4B', X'BA'-X'BB' and 216 bytes of a non-critical area in the supervisor). Two 
types of dump programs can be generated using DUMPGEN: 

• Translating dump 

• Formatting dump. 

Both programs produce a conventional dump with translation. In addition, the 
formatting dump produces a pre-formatted printout of the DOS/VS interface 
tables. This dump is generated if the DUMPGEN option FORM AT= YES is 
specified. 

Executing DUMPGEN 

Before being able to execute DUMPGEN you must catalog it to the core image 
Hbrary. The DUMPGEN program may be executed in any partition. Before 
executing it with the job control statement or command 

// EXEC DUMPGEN 

the output device must be assigned. The output device must be assigned to 
SYSPCH for cards or tape, and to SYS006 for diskette. The DLBL statement 
for diskette must be: 

// DLBL IJSYS06, 'filename' „ DU 
All DUMPGEN control statement will be read from SYSIPT. 

Note that SDAIDS may not be initiated during execution of DUMPGEN. 
(SDAIDS are described in Section 2-B.) The two types of control statements used 
with DUMPGEN are ASSGN and OPTN, described as follows: 

ASSGN Statement: ASSGN defines the output device which will be used by the 
stand-alone dump program. This statement should not be confused with the 

// ASSGN job control statement. 



DUMPGEN AND 

STAND-ALONE 

DUMP 




o 



Name 


Operation 


Operand 


(blank) 


ASSGN 


SYSLST, X 'cuu' 



SYSLST The only valid logical unit assignment. 
X'cuu' Must define the address of the SYSLST printer. If the ASSGN 
statement is omitted, then X'OOE' is assumed. 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



OPTN statement: OPTN defines the type of output generated by the DUMPGEN 
program. 



Name 


Operation 


Operand 


(blank) 


OPTN 


INTR=NO 
YES 

DECKS= 1 

nnnnnnnn 

PPOOL= NO 
YES 

FORMAT= NO 
YES 

DSKTIPL= NO 
YES 

TAPEIPL= NO 
YES 



Operands for the DUMPGEN option statement. 

INTR YES produces a DUMP program that, when loaded, enters the WAIT 

state. Either press the INTERRUPT button on the CPU operating 
panel to print the output on X'OOE', or press the STOP button and 
then START button of the printer desired for the output device. 
NO produces a DUMP program that, when loaded, prints out the 
contents of real storage either on the SYSLST printer defined with 
the ASSGN statement or on X'OOE'. 

DECKS Specifies the desired number of REALDUMP copies to be punched 
out on the card-punch or written on diskette or tape, nnnnnnnn may 
be any decimal number from 1 to 99,999,999. A blank card separates 
each deck produced. If DECKS is omitted, one REALDUMP program 
is produced. 

PPOOL YES produces a dump program that, after printing out real storage, 
will print the formatted contents of the Boundary Box and the 
contents of the real storage in sequence of ascending virtual addresses. 
If NO is specified, the last two items are not printed. 

FORMAT YES produces a translating stand-alone dump that formats and displays 
the DOS/ VS supervisor tables after displaying the contents of real 
storage. This formatted display depends upon the location of the 
communications region. 

If the communications region cannot be related, the program is 
terminated when the formatted display is to occur. 
In this case the following message is printed on the dump output: 

COULD NOT FIND COMREG BETWEEN CO AND AOO, 
FORMATTING WILL NOT OCCUR 
If the information to be formatted has been destroyed, 
results are unpredictable. 

DSKTIPL If YES is specified and SYS006 is assigned to a diskette I/O unit, the 
stand-alone REALDUMP program written on diskette may be IPLed 
directly from the diskette. 

If NO is specified, or DSKTIPL is omitted and SYSPCH is assigned to 
a diskette I/O unit, the stand-alone REALDUMP program is written 
on diskette with each record preceded by an ASA control character. 

TAPEIPL If YES is specified and SYSPCH is assigned to a tape unit, the stand- 
alone dump written on tape may be IPLed directly from the tape unit. 
If NO is specified, or TAPEIPL is omitted and SYSPCH is assigned to 
a tape unit, the stand-alone dump records are written on tape preceded 
by an ASA control character. 
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Dumps of, and changes to Real and Virtual Address Areas 

Control statements for theDUMPGEN operands DUMPGEN AND 

STAND-ALONE 

Control statements may be specified in any order; however, the following rules DUMP 

apply: 

• All statements may be omitted, but if they are, DUMPGEN assigns printer 
X'OOE', INTR=NO, DECKS=1 , DSKTIPL=NO, FORMAT=NO, and 
PPOOL=NO options and the output will be on the device assigned to SYSPCH 
(with or without ASA control character, depending on the device type). 

• Only one operation and only one operand per control statement is allowed. 

• The last statement processed of a duplicate operation overrides all 'Previous 
statements of the same operation with similar operands (if DECK^. =2 is 
followed by DECKS=5, five decks are punched). 

• The name field must be blank. 

• Decimal operands may contain leading zeros. 

• One or more blanks must follow the operand if comments are to be made. 

Job stream examples 

1, To create a stand-alone dump program on cards or tape: 

// JOB CARD DUMP 

// ASSGN SYSPCH,X'cuu' 

// EXEC DUMPGEN 

ASSGN SYSLST,X'OOF' 

OPTN FORMAT = YES 

OPTN PPOOL = YES 

OPTN DECKS = 1 
/* 
/& 

This will create a single stand-alone dump program on cards. The program 
will use the printer X'OOF' for dump output. 

2. To create a stand-alone dump program on diskette: 

// JOB DISKETTE DUMP 

// DLBL IJSYS06, 'filename'„DU 

// EXTENT 

// ASSGN SYS006, DISKETTE 

// EXEC DUMPGEN 

OPTN DSKTIPL=YES 

OPTN FORMAT=YES 

OPTN PPOOL=YES 

OPTN DECKS = 1 
/* 
/& 

This will create one single stand-alone dump program on diskette. The 
program will use the default output printer X'OOE', as no ASSGN statement 
was provided. 

Note: If a 3211 is the only printer in your installation, the indexing feature 
should be used with great care; shifting the print line to the left 
or too far to the right causes loss of a certain number of characters 
on each line of the dump. 
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DUMP 



DUMPGEN messages 

The functions of DUMPGEN-to-operator error message routines are: 

• Cancel the job if SYSLOG is not a 3215/3210 or a System/370 Model 125/1 1 5 
video display unit. 

• Reissue the message if operator response is to press the CANCEL key 

• Process an operator response of END/ENTER as IGNORE 

• Cancel the job if operator response is CANCEL 

• Ignore the control statement in question when the operator response is IGNORE. 

If none of the preceding operator responses is issued, then DUMPGEN assumes 
that a correction has been made and processes it. 

Stand-alone Dump Program (REALDUMP) 

This program is generated for your installation using the IBM program DUMPGEN. 

DUMPGEN produces a dump program that is either punched into a card deck or 
stored on magnetic tape or diskette. When required, the dump program thus gene- 
rated can be loaded into the system via the standard IPL procedure. 

The stand-alone dump program that is generated by DUMPGEN provides either 
a conventional dump or a formatted dump, depending on the FORMAT option 
used in the DUMPGEN program. 
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Operation 

During execution of the stand-alone dump program, a non-critical area in the 
supervisor is used to load the program. The LOAD ADDRESS of the non-critical 
area is punched (in decimal) in the first record of the stand-alone dump program 
punched by the DUMPGEN program. Because of this use of the non-critical 
area it is recommended to use the stand-alone program for a system using a 
supervisor that was used for the generation of that dump. 

The conventional dump prints the contents of real storage locations, but does not 
dump the floating point registers. In addition to the areas dumped by the conventional 
dump, the formatted dump prints the DOS/VS interface tables in a more 
readable form. 

For both types of dump the following is printed: 

1 . The contents of the general registers, the old and new PSWs, the interruption 
codes, CSW, CAW, and TIMER. 

2. The contents of real storage in 2K blocks. Each block is preceded by a 
sequence number. 

3. At the end of the real storage dump, page address and status information is 
printed that contains the following information for each page frame: 

• The virtual address 

• The real address of the associated page 

• The sequence number of the 2K block 

• Information that indicates whether the contents of the page frames 
has been changed. 

4. The contents of the control registers are printed after page address and 
status information. 

5. Depending on the options selected, the following then occurs: 

IfPPOOL=YES 

• The formatted contents of the boundary box is printed after the 
control registers. 

• The contents of real storage is printed in 2K blocks in sequence of 
ascending virtual addresses. 
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IfFORMAT=YES, DUMPGEN AND 

the formatted contents of the tables Usted below are printed at the end STAND-ALON E 

of the dump. DUMP 

PARTITION SAVE AREAS 

COMREGS 

PIBs 

AP SUBTASK PIBs (if AP supported) 

LUBs 

PCIL LUBs (if PCIL supported) 

PUB 

ERROR RECOVERY BLOCK 

CHANNEL QUEUE 

FLOATING POINT REGISTERS 

COPIED AND TRANSLATED CCB 

FIXINF EXT. BLOCKS 

COPIED AND TRANSLATED CHANNEL PROGRAM 

IDAL BLOCK QUEUE 

FIXINF BLOCK 

BOUNDARY BOX 

SEGMENT TABLE 

PAGE TABLE 

PAGE FRAME TABLE and PAGE FRAME TABLE EXT 

SELECTION POOL 

The full names of these tables, their contents, locations, and meaning to 
the system programmer during offline program debugging are found in 
Section 4. 

An example of the formatted output of these tables is given in Appendix G. 

The two following illustrations show the information that is printed 
after executing the dump program. 

When to use 

The stand-alone dump program must be used whenever the severity of a 
system malfunction, such as a loop or hard wait state, prevents alternative 
methods of obtaining system information that aids offline debugging. 

Flowcharts in Section 3 indicate when to execute the stand-alone dump 
program. 
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16 General Registers 

Low address storage 
(Formatted). 



Last 2K block of 

real storage. (Without translation.) 



First 2Kblock of real storage 
beginning at byte 0. (With translation). 



2K blocks of real storage, (With translation). 



Last but one 2K block of real 
storage, (With translation). 



Page address and status information 



16 Control Registers. 



The contents of tables and areas 

as listed in the previous text are printed 

(See appendix G for an 

example of formatted output of these areas) 



PSWS 
EXT OLD 
EXT NEW 
EXT INT 
SVC OLD 
SVC NEW 
SVC INT 
PGM OLD 
PGM NEW 
PGM INT 
MCKOLD 
MCK NEW 
MCK INT 
I/O OLD 
I/O NEW 
I/O (NT 
CSW 
CAW 
TIMER 



o 
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FORMAT=YES 



A pictorial representation of the stand-alone dump and formatted 
printout, generated using DUMPGEN options FORMAT=YES 
and PPOOL=NO. 
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J'^b/ocksofrea; 
.^^o'-age, printer 

'" ascending 
sequence of 

;^.^«;«' addresses, 
^'^'^'^^'-ans/atfonh 



PPOOL=Yes 
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ss Areas 
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-'-"■' ^xtnew 

-; EXT //VT 

'-- SVC OLD 

/- SVCiVEi/s/ 

' SVC tNT 

PGM OLD 
PGM IN/Eyy 

;: PGM l/VT 
., 'WCKOLD 
'" '^CK NEW 

'/OOLO 
'/O NEW 
I/O INT 

csw 

CAIV 
TfMER 
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DUMPGEN AND A note to the operators 

STAND-ALONE 

DUMP Before the stand-alone dump program is executed, the operator must dump, or ^ ^ 

display and note, the contents of bytes X'OO' through X'l 7', X'40' through'x'4B', \_>^ 
X'BA', and X'BB' of low address storage. (The contents of these bytes will be 
destroyed when the dump program is loaded.) It may be important to the pro- 
grammer to have a note of the contents of the control registers at the time of the 
error. This can be done by (1) executing the store status function or (2) dumping 
or displaying the control registers using the ALTER/DISPLAY feature described 
in Section 2-D. The operator should also display and note the current PSW before 
executing the dump. Also there may be a need to dump the page data set after 
executing the stand-alone dump. For example, the programmer may have made a 
request for a "SYSVIS dump" after the execution of a stand-alone dump. The 
flowchart shown opposite indicates the procedure for loading and executing the 
stand-alone program. 

A note to the programmers 

To ease the task of locating and interpreting the contents of control blocks and 
tables during offline debugging, generate the formatted dump program 
(FORMAT=YES). 

AnotetoIBMSE/CE 

For any System/370 supporting RAS the serial number and System/370 Model 
type is stored in the first 8 bytes of the RAS Hnkage area, the address of which 
is located at displacement X'70' of SYSCOM . 

How to use 



Initially the following Usted areas should be examined, for what appears to be 
unexpected information. 
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1. General registers. . 

2 . Current PSW and old PSWs. J ^®^ "°^® ' 

3. From the PIB table locate the partition in control at the time of the error. 

4. Registers and the PSW in the partition save area. 

5. Using the program listing of the program that was running in the failing 
partition, scan the I/O areas, instructions, intermediate results, and 
operands in areas you consider critical to the program. 

6. Use the linkage editor map to locate where the system should load the 
phases. 

7. For further analysis, check the PUB table for any I/O request left out- 
standing, and, depending on the type of the program in error, check the 
CCB/DTF table and label save areas. 

The order in which these areas are examined rests with you, who as programmer, 
will know what the program was expected to do, and approximately what the 
contents of certain registers and I/O areas should contain. 

An example of a stand-alone output is given in appendix G. 

By examining the dump in this way and by consulting the program Usting you 
will be able to form an idea of the cause of the error, and to discover where to 
look for further clues or pointers. 

However, the first pointer will depend on the symptoms of the error, the 
environment, what the program was expected to do, any output that became 
available, and incorrect results of calculations. 

Note: Use the information printed at the start of the dump, that is before the print f 'i 
out of blocks of real storage. The first block printed is the last block of real storage. ^ --^ 
(The contents of low address storage is not reliable after the execution of a 
stand alone dump program. ) 
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DUMPGEN AND 

STAND-ALONE 

DUMP 



Start 






DISKETTE 



Place the diskette 
in the hopper of the 
diskette I/O unit 
and press START 



Before executing, dump, 
or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 
X'OO'-X'BF' 




See D-1-F for Models 135, 138, 145, 148, 155-11 
and D-2-F for Models 1 15, 125 
and D-3-F for Model 158 



A-3-F 



CARD 



Mount tape on a tape 
unit ensuring that the 
number of tracks and 
density is identical to 
that used when the 
tape was produced 



Set address of I PL 
device (diskette, tape 
unit, or card reader) 
in address switches 
or in display 



Place card deck in a 
card reader 



To next page 
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DUMP 



A wait state occurs if 

INTR YES is specified 

during generation of the 

dump program using DUIVIPGEN. 



The contents of REAL storage is 
printed in blocl<s of 2K bytes on 
the line printer specif ied in the 
ASSGN statement of DUIVIPGEN 
or the line printer made ready 
after entering the WAIT STATE. 
Other information is also printed 
depending on the type of dump 
program generated by DUMPGEN. 



The SYSVIS dump utility program 
is described under C-6 in this Section 



Example 1 

// JOB DUMPPDS 
//ASSGN SYSOOO,X'cuu' 
// ASSGN SYS001,X'cuu' 



// 
// 
// 
// 
// 
/& 



From previous page 




Press the STOP key, 
the SYSTEM RESET 
key, and the LOAD 
key, in that order 




YES 



NO 



Press the INTERRUPT 
key, or the START 
button on the printer 
desired as output 
device 



J 



The DUMP is 
executed 



The following procedure executesithe SYSVIS dump utility program. This 
procedure copies the PDS to tape or disk which can then be dumped to SYSLST 
if required during offline debugging. It is also possible to dump the PDS directly 
to SYSLST. To ensure that the contents of the PDS and the allocations of the 
virtual address area are the same as they were just prior to the execution of the 
stand-alone dump the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical 
virtual partition allocations as existed just before the stand-alone dump was 
executed. 



DLBL PDSDISK/PAGE DATA SET' 
EXTENT SYSOOO 

DLBL S01DISK,'BACKUP FOR PDS', 
EXTENT SYS001,1 1 1 1 1 1,1„0020,180 
EXEC PDSDM 







YES 



Use the SYSVIS dump to 
copy the PDS to disk. 
See JCS example 1 



Use the SYSVIS dump to 
copy the PDS to tape. 
See JCS example 2 



Example 2 

// JOB DUMPPDS 

ASSGN SYSOOO,X'cuu' 

ASSGN SYS001,X'cuu' 

DLBL PDSDISK,'PAGE DATA SET' 

EXTENT SYSOOO 

TLBL S01TAPE/BACKUP FOR PDS' 

EXEC PDSDM 



Wait for message 0V20D 
on SYS LOG then press END 



// 
// 
// 
// 
// 
// 
/& 



Save the copied PDS for your 
system programmer and/or 
IBM CE/SE. He may need 
it to complete offline 
program debugging. 



Continue normal processing 
with the next job 
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DOSVSDMP AND 
STAND-ALONE DUMP 

This program creates a stand-alone dump program which writes a storage dump 
in a file on tape or disk. This file can be printed during normal system operation 
at the user's convenience. 



The dump program may reside on tape or disk. When the dump program is 
executed, the dump is written onto the same device from which it was IPLed. 

The program produces a copy of virtual storage in virtual page order, and a copy 
of real storage in real page order. Pages which are allocated but paged out to 
SYSVIS are included in the virtual dump. 

The storage dump can be printed either formatted or unformatted. In a formatted 
printout each field identified is printed with certain system control blocks (refer to 
Appendix G). The unformatted printout is only a conventional translated copy of 
storage. 

Note: 7-track tape drives without data convert are not supported by DOSVSDMP. 



o 



Creating a stand-alone dump program 

Before you can execute DOSVSDMP, it must be cataloged to the core image library. 
The dump program can be generated in a tape resident version or in a disk resident 
version. SYS006 must be assigned to the device on which the stand-alone dump 
program is to be v^nritten. 

How to create a tape resident stand-alone program 

1. Select a non-labeled tape to be used as the dump volume. 

2. Execute DOSVSDMP: 

// JOB 

// ASSGN SYS006,TAPE 

// EXEC DOSVSDMP 

/& 

3. When message 4C75D is issued, reply: TAPECREATE 

4. Message 4C79I indicates that creation of the dump program tape is completed. 

5. Message 4C75D is issued again. Reply: EOJ 

Refer to DOS I VS Messages for an explanation of the above messages. 
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DOSVSDMPAND 

STAND— ALONE DUMP How to create a disk resident stand-alone dump program 

1. Select a disk pack to be used as the dump volume. Note that the IPL text on 
the pack will be replaced by the dump IPL text. The selected pack cannot be 
a system residence volume. 

2. Before you can execute DOSVSDMP, the file which is to hold the dump output 
must be allocated on the selected volume. This file must be named DOSDMPF, 
and begin and end on a cylinder boundary. The size of the file is calculated 
using the following formula: 

N>=((2 + V+R)/T)+2 

where 

N is the number of tracks needed, 

V is the number of pages in the virtual address area, 

R is the number of pages in real storage, 

T is: 3 for 2314/3340 devices, 

6 for 3330-1 /333a 11 devices, 

8 for 3350 devices. 

The result N must be rounded to the next higher number of tracks equivalent to 
the next whole number of cylinders. 

3. Execute DOSVSDMP: 

//JOB 

// ASSGN SYS006,DISK 

// DLBL DOSDMPF,Tilename' 

// EXTENT SYS006,balance of extent information ^ 

// EXEC DOSVSDMP 

/& 

4. When message 4C75D is issued, reply: DISKCREATE 

5. Message 4C79I indicates that creation of the dump program disk is completed. 

6. Message 4C75D is issued again. Reply: EOJ. 
Refer to DOS/VS Messages for an explanation of the above messages. 
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DOSVSDMPAND 
Executing the stand-alone dump program STAND— ALONE DUMP 

The program is activated via an IPL of the tape or disk containing the dump 
program. The IPL procedure overlays storage locations X'OO' to X'24' and loads 
the program into storage locations X'AOO' to X'AFF'. Once loaded, the pro- 
gram proceeds to write out storage in virtual page order. Following the virtual 
storage dump, or as a result of an error in attempting to dump virtual storage, 
a dump of real storage in real page order is taken. Upon completion of the dump 
message DOSVSDMP COMPLETE is issued and the system is placed in the wait 
state with a completion code in bits 48 to 63 of the current PSW. 

In addition to any local procedures specified for such cases, the following 
steps should be taken when a stand-alone dump is required: 

1. Record any error or status indicators on the system console. 

2. Using ALTER/DISPLAY, record the current PSW, general registers, and 
floating point registers. 

3. Perform the Store Status procedure for your system. 

4. Mount and IPL your dump program tape or disk. 

5. If message "DOSVSDMP COMPLETE" is displayed, restart DOS/VS and 
prepare to print the dump as soon as the system has been restarted. 

6. If the stand-alone dump program cannot be completed, due to errors, it 
enters the hard wait state with an error code stored in the current PSW. 
See the section "DOSVSDMP Hard Wait Error Codes" in DOS/VS 
Messages for details of these codes and subsequent action. 
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DOSVSDMPAND 
STAND-ALONE DUMP 



Printing the stand-alone dump output 

For printing the stand-alone dump output, the program requires a partition size 
of at least 36K plus the size of the supervisor to be printed. 

1. Execute DOSVSDMP: 

//JOB 

// ASSGN SYS006,device 

// DLBL DOSDMPF/filename' 

// EXTENT SYS006,balance of extent information 

//EXEC DOSVSDMP 

/& 

SYS006 is assigned to the device which contains the dump file. 

2. When message 4C75D is issued, reply with one of the following options: 

FORMAT for a formatted printout of the dump file (see note below). 

FORMAT,REAL for a formatted printout and a conventional translated 
printout of real storage following the virtual storage 
printout (see note below). 

for an unformatted printout of the dump file. 

for an unformatted printout and a conventional 
translated dump of real storage. 

3. Message 4C81I will be issued, indicating the default print selection options. 

4. Then message 4C80D is issued to allow you to change the print selection 
options. The options may be entered separately or as one reply, in which 
case they must be separated by a comma. The options are: 

( YES) If SYSVIS= YES is specified the pages retrieved from 

SYSVIS during the dump will be printed. For unformat- 
ted dumps SYSVIS= YES is the only valid option. 

If SVA==YES is specified the Shared Virtual Area will 
be printed. 



DUMP 
DUMP,REAL 



SYSVIS= 



(NO 
:YES"i 



SVA= 



NO 



MLLjIf PARTITION=ALL is specified the supervisor and 
PARTITI0N=4 ^ Ml partitions will be printed. If PARTITION=xx is 

(xx 'specified the supervisor and only the specified partition 
are printed, xx must be a valid partition ID, 

Press END/ENTER to terminate option selection. Message 4C81I is issued to 
display the selected options. 

5. When message 4C75D is issued again, repeat step 2 or reply with EOJ. 

Note: If a block which is to be formatted has an invalid address, printing will be 
cancelled. In this case, the fob should be run again, using the DUMP option. 
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PDAIDS TRANSIENT DUMP 

PDAIDS (problem determination aids), are routines especially designed to 
provide specific information useful during offline debugging. These routines 
consist of four trace routines, which are described in Section 2-B of this manual, 
and one routine called the transient dump program. 

Transient Dump 

This program is designed to dump, on a program check, areas of the supervisor 
before they are altered. The dump provides: 

• the 1 6 general registers 

• the 1 6 control registers 

• the first X'20F' bytes of low address storage 

• the logical transient area (with the label LTA) 

• the physical transient area (with the label PTA). 

This information may be provided on either a printer or a tape unit. When tape 
is used, the tape must be processed by the PDLIST utiHty program to provide 
readable output data. PDLIST is described in Section 2-B. Both the printer and 
tape modules are reusable, that is a dump occurs with each program check until 
the function is reset. 

The printed dump output is non-translating. 



System requirements 

Because the Transient Dump program is a PDAID function, it requires the 
PDAID initializing phase and a PD area. Refer to "System Requirements" 
for Trace Routines in Section 2-B-i. 
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TRANS! ENT DUMP Initializing the transient dump 



Initializing is done by calling the PDAID program via the job control statement 
//EXECPDAID. 

The parameters for the dump may be entered on SYSLOG or SYSIPT, 

Note: No other PDAID can be executed when the transient dump program is 
initiated. 






If SYSIPT is to be used, the input must be either punched cards or diskette 
records. These input control statements must comply with the following rules. 

Each statement has a maximum length of 80 bytes, and may contain either a 
single entry or multiple entries separated by commas. An entry may not be spMt 
between two statements. A statement is terminated by the first blank following 
an entry or by a GO entry. The last entry of the last statement must be GO, and 
this last statement must be followed by a /* statement. 

Note: If an incorrect parameter is read from SYSIPT, corrections are requested 
on SYSLOG. 



When the main phase (PDAID) has been loaded into any free partition (one must 
~ be made available), the following message is issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

• TD Initiates transient dump. 

• XX Terminates PDAID. 

• END key Indicates that the parameters are to be entered via SYSIPT. 



V .-x' 
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Selecting the Output Device T R A N S I E N T D U M P 

The initializer keyword OUTPUT DEVICE selects an output device, which must 
be specified by channel and unit address, not by symbolic unit. When an output 
device is specified, the initializer checks the address against the supervisor PUB 
and automatically selects the appropriate module for the unit type (tape or 
printer). 

Once the transient dump program has been initiated, it is given control each time 
a program check interrupt occurs. When it has control, the transient dump 
program has highest priority, and the system accepts only external interrupts. 
All system processing is suspended and the operator must ready the transient 
dump output device. 

W/ien to use 

Use the Transient dump when you suspect coding errors in the transient routines, 
for example, your own error recovery routines for devices not supported by IBM. 
The information obtained from the dumps will help during offline program 
debugging. 

Terminating tlie transient dump 

The transient dump program can be terminated by re-initializing the PDAID 
program (// EXEC PDAID), and responding to the message PDAID= with XX. 
It is also possible to reset (terminate) the transient dump by loading one of the 
PDAID trace routines. 

The following illustration represents the action of the transient dump program if 
a program check interrupt occurs in the LTA. 
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TRANSIENT DUMP 






16 general registers 
16 control registers 



527 bytes decimal of 
low address storage 



Supervisor transient areas 
(Refer to Section 4 for details) 



Line printer 

or 

magnetic tape 



Pictorial representation of the information that is dumped. 



Real Storage 



Low Address Storage 



Model dependent 
log out area 



Supervisor Transient 

Area 

(LTAandPTA) 



Background 
Partition 



^ 



> 



SUPERVISOR 
AREA 
(Refer to 
Section 4) 



J 



'X,.-.-^ 



Keyword 


Parameter 


Meaning 


Default 


PDAID 


TD 
XX 


Initiate transient dump. 
Terminate function 


Function 
continues. 


OUTPUT 
DEVICE 
(Note 2) 


CUU or X'cuu' 


Use specified output device for output of 
transient dump function. 




GO 
(Notel) 




End of initializer keyword entries. 





Note 1: GO is an invalid response to a request for a console correction of SYSIPT input. 

Note 2: A printer or tape output device must be specified for transient dump. 

CUU or X'CUU' notation must be specified by channel and unit address, 
and not by symbolic unit. 

Two examples of initiating the transient durfip immediately follovy the flowchart shown opposite. 
Table A-4. Table of parameters for initializing the Transient Dump 
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Dumps of, and changes to Real and Virtual Address Areas 



TRANSIENT DUMP 
Initializing the Transient Dump 



//JOBDUMPTA 
// EXEC PDA! D -■ 



4C10DPDAiD = 



Enter XX 
and press 
END 



Enter TD 
and press 
END 



Press 
END 



4C1 ID OUTPUT DEVICE = 



Terminate 
Transient Dump 



Select output 
device 






Transient Dump 
is initiated 



Print the Transient 
Area 



Read Parameters 
from SYSIPT 



A-4-F 




//EXEC PDA! D 

PDAID=XX 

/* 

//ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

// EXEC PDLIST 

/* 

/& 



Tlie LTA and PTA will be 
dumped on the selected output 
device if a program check interrupt 
occurs in the transient area 



Print dump using 
PDLIST utility 



Serviceability Aids 2.33 



Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP Job stream examples 



The following two examples show job stream to initiate the transient dump |^ y 

program. 

Example 1, via SYSIPT: 

//J0BCARDINP7 

// EXECPDAID Calls for initializer. 

PDAID=TD Calls for transient dump function. 

OUTPUT DEVICE=OOE Specifies printer output. 

GO Signals end of input. 

/* 

/& 

Note: A dump is given on all program checks 

Example 2, via SYSLOG: 

//J0BTYPINPT6 

//EXECPDAID Calls for initializer. 

PDAI D= Console requests function. 

TD and END key Operator specifies transient dump function. 

OUTPUT DEVICE= Console requests output device. 

OOE and END key Operator specified printer output. 

An output device must be specified for the transient dump function. 

If this is a 321 1 printer and the printer's indexing feature is used, 

it may occur that not the full length of every line of the dump is 

printed. This loss of characters can be avoided by disabling the /^ A 

indexing feature. This is done by loading a new FCB image into V_y 

the printer's FCB in one of the following ways: 

Using the SYSBUFLD program. 

This method is to be used when the transient dump is entered via 
SYSIPT. The job stream as shown in example 1 , 
would then have to be as follows: 

//JOB 

//EXEC SYSBUFLD 

FCB SYSxxx,phasename 
/* 

//J0BCARDINP7 
//EXECPDAID 



Using the LFCB command 

This method is to be used when the transient dump is initialized 
by means of the console printer keyboard (SYSLOG). The job 
stream as shown in example 2 would then be as follows, 

LFCB X'cuu', phasename 

//J0BTYPINPT6 

//EXECPDAID 

phasename = the name by which the FCB image is cataloged. 
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Dumps of, and changes to Real and Virtual Address Areas 

TRANSIENT DUMP 



o 
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O0040308 
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000084 BC 


00000008 00040280 
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00040078 
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000082E8 
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004000FF 


0000E640 FFFFFFFF 


FFFFFFFF 


00000000 


OOOOOOOO OOOOOOOO 


OOOOOOOO 
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OOOOOO 


OOOOFFFF 
00000000 


00000000 00000000 
00000000 00000000 


00000000 
00000000 


00000000 
00000000 


OOOOOOOO C2000000 
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00000200 
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00000000 


00000000 070F2000 


0000090C 
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OOOOOOOO 


FE3BD600 
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040COO0O 
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0000A50C 


04080000 
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OOOOOBIO 


00000540 
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OOOOOICC 


00000000 
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000002C0 


OOOOOOOO 


00000100 00000130 OOOOOOOO \ 
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00000000 


00000000 00000000 


00000000 


00000000 


OOOOOOOO OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO OOOOOOOO OOOOOOOO \ 
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00000000 


OOOOOOOO OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO OOOOOOOO OOOOOOOO 1 






000120 








30000000 


OOOOOOOO OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO OOOOOOOO OOOOOOOO 1 
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30000000 


OOOOOOOO OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO OOOOOOOO OOOOOOOO / 
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30000000 
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OOOOOOOO 


OOOOOOOO 
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F0389551 80044780 F0380300 F4188004 / /ilkl 
9110*087 47E0F05E 94EF*087 0*0B9550 ^ ** ^1^1 




5B5BC206 


D7C 50540 It 7#OF0OE 
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4780F0B6 ?r013002 
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F4184770 


F070S860 20080201 


402 66006 


4110F41A 


0*024110 F42A94F7 


*0 870*02 


4110F43* 


94FD3002 0*024110 F43294FE •' •' 






« / 0083T8 


30020*02 


4110F422 0AO2OAO0 


91801002 


4710F0A6 


0AO79120 10024710 


F0B007F9 


92FFF419 


07F94160 F3F04060 100A4590 






yj /«/•./ 0083*8 
^^d/'^TA/ 008308 
if 008408 


F09*9108 


F2D74710 F0DCD605 


40204020 


4780F038 


96044003 47F0F638 


9104*087 


47E0F0EC 


94FBA087 4TF0F104 4160F3F8 






4060100* 


4590F09A 416QF400 


4060100* 


4590F09* 


95FFF419 4780F038 


9118*087 


4770F11C 


91112014 4710F126 D503F2EE 






F40E4780 


F12CD205 F2F2F412 


05054020 


F4084780 


F234D505 4020F2F2 


4770F15* 


0505F2F2 


F4124770 F2349110 30024710 






• 008438 


F15*9112 


201447E0 F234076B 


F26*F26* 


9280F288 


9203F282 D201F286 


8004920* 


F28*0201 


F2e48000 9206F291 D205F2B4 






008468 


F2069201 


F2899S50 80044780 


F1B89218 


F2919214 


F28A0217 F2BEF206 


9204F289 


926CF3DC 


95538004 4770F1B8 9209F291 






_ 008498 


9205F289 


925DF30C 0205F292 


40200200 


F2*58005 


0201F29E 400B0201 


F2*24012 


0201F2AO 


40010200 F2A44000 D203F2A6 






• 0084C8 


400ED201 


F2984026 95508004 


4770F214 


D209F2** 


40300602 40004000 


4780F234 


D7024000 


40000733 40084008 9250F3DC 






0084F8 


47F0F230 


0213F2AA 40300602 


40004000 


4780F234 


07024000 40000738 


40084008 


4590F24A 


9110A087 4710F240 96044003 






. 008528 


02054020 


F2F247F0 F038D203 


F266F30C 


18514110 


F2660A2C 9180F268 


4710F262 


aA071815 


07F958A0 O01458B0 A0885830 






• 008558 


B01C4110 


F3E09118 A0874780 


F 2*24000 


10064590 


F3821821 4SE0F394 


1B444347 


00008940 


00014844 30345A40 303047F0 






008588 


F0B69180 


A0594710 F0701820 


91033002 


4740F34E 


9104A058 4710F32E 


91013004 


4710F320 


1B0018C0 412CO00O 95002000 






^ 0085B8 


4770F320 


58220000 95FF2007 


4780F2F0 


95202014 


4740F2F6 95282014 


4720F2F6 


96013004 


07F99532 20144770 F31845E0 






• 0085E8 


F39495FE 


700047B0 F318D300 


F4188004 


9560F418 


4780F2F0 41000004 


47F0F2C8 


94FE3004 


18205822 000047F0 F34ES820 






008618 


F4AC9500 


20044780 F34A9102 


A0S847E0 


F0705822 


000047FO F34E5822 


000495FF 


20074780 


F0709520 20144740 F366952a 






. 008648 


20144700 


F0700201 10062006 


45E0F394 


1B664360 


70008960 00014846 


30345*40 


30304160 


F2064060 F3F24160 F2EE4060 






• 008678 


F3F*07F9 


487*0070 488A002E 


48887002 


487*004* 


D200F3BB 70001B77 


43720007 


91012006 


47E0F3BC 41770000 1A781A77 






0086*8 


4*7*004C 


IB884387 00008980 


00034A8A 


004007FE 


OOOOOOOO OOOOOOOO 


00300400 


00001500 


OOOOOOOO OOOOOOOO 20000000 






. 008608 


04000206 


20000018 020002EE 


2000000C 


07000400 


20000001 OOOOOOOO 


0000ES06 


D3F14040 


40404040 00005B5B C20607C5 






• 008708 


05F15B5B 


C20607C5 05C45B5B 


C201C306 


07E35B5B 


C20604E3 F0F15B5B 


C2D6D4E3 


F0F50000 


OOOOOOOO 00005C00 012C0000 






008738 


84000000 


92600004 00006060 


C2C76060 


C3 060409 


C5C74040 C2C740C1 


C4C40940 


C9E240F0 


F0F0F4C1 F0D3C203 E3E80740 
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40C8C5E7 
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F0F0F060 
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09C5C100 


000020F2 
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903547E0 
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D2016006 
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4780B09A 
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43405000 
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10004770 


B0689283 A0009680 
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905A94DF 
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4A20905A 


18A248F0 


C00847F0 B23C4100 


829094*0 
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B14AD508 802AB342 4780a21A 
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D505802* 


B3364770 B14A1SAD 


4850C02C 


4860907C 


41AA0010 41660010 


0501 8031 


83424780 


81200501 B031A002 4770B142 






• 00eF80 


9180600F 


4780B1A8 4140B21A 


4100B208 


9226B267 


9220B264 4570B14A 


9260B264 


07F44650 


B10492F2 B2ABBE07 B2614100 






OO8FB0 


B260BE07 


B31F4100 B02ABE07 


B271D708 


B02AB02A 


4100B34C BE07B269 


4110B316 


0A0F9180 


10024710 B17COA07 9120B318 






^ 008FE0 


4710B21A 


9218B267 9101B31A 


4780B19C 


4100B270 


BE07B31F 47F0B15E 


0608B02* 


B3424100 


B2A807F7 4100B2C0 91029035 






• 009010 


47E0aiE6 


4120000F 4B2OC02C 


4830C02C 
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A0024770 
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• 0090*0 
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• 009130 
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F4F0F040 


E2027EF6 


F1F6FIF0 FOFOFOFO 


FOFOFOOO 


F007FOF8 


C1404040 40C90SE3 C509E540 , ^ ^ . 
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Transient Dump output 

This example shows the output obtained from the transient dump program. (The dump is 
output when a program check occurs in the transient area.) 

The programmer's remarks on this example indicate the main points of interest to aid offUne 
debugging. They, however, depend on the error symptoms and system environment. 
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SUPERVISOR 

COMMUNICATION 

MACROS 



Dumps of, and changes to Real and Virtual Address Areas 

PDUMP (partial dump) macro 

This macro instruction provides a hexadecimal dump of : 

• The general purpose registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The virtual storage area contained between two address expressions. 

The addresses can be expressed in decimal or hexadecimal or in register notation 
and need not be confined to any one partition. 






Name 
(name) 


Operation 
PDUMP 


Operand 

address 1 , address 2 
(r) (r) 


Address 1 
Address 2 


specifies the start address of the 
storage to be dumped, 

specifies the end address of the storage 
to be dumped. 



(r) one or both of the addresses can be 

specified in any of the general registers. 

The contents of registers 0-1 are destroyed, but the CPU status is retained. Thus, 
PDUMP furnishes a dynamic dump (snapshot) that is useful for program checkout. 
Processing continues with the next user instruction. 

The dump is always provided by SYSLST on 121 -byte records. The first byte 
is an ASA control character. If SYSLST is a disk drive, the user must issue an 
OPEN macro to any DTP assigned to SYSLST after each PDUMP that is 
executed. The OPEN macro updates the disk address maintained in the DTP table 
to agree with the address where the PDUMP output ends. If OPEN is not issued, 
the address is not updated, and the program is canceled when the next PUT is 
issued. 

The specified addresses are checked against the end address of virtual storage. If 
address 1 is higher than the end address of virtual storage, or if address 1 is higher 
than address 2, the PDUMP macro results in no operation. If address 2 is higher than 
the end address of virtual storage, address 2 is automatically set to that address. 

If address 1 and 2 are identical, only the contents of the general registers, the 
control registers and floating point registers are dumped, (Floating point registers 
are dumped only when the supervisor supports the floating point option,) The 
dump output can be either standard (non-translating) or translating, depending on 
the dump program cataloged in your system transient library. 

Note: Addresses for this macro may not be specified by register notation for 
programs eligible to run in the SVA (shared virtual area). 



\ .1^ 



2.36 Serviceability Aids 



Dumps of, and changes to Real and Virtual Address Areas 



When and how to use 

PDUMP is useful when you need to know the contents of specific virtual storage 
areas at specified points in the program during program execution. For example, 
you may want to examine the contents of storage areas that are being modified 
during program execution, such as I/O areas. 

The following example illustrates the use of the PDUMP macro. 



SUPERVISOR 

COMMUNICATION 

MACROS 



003C7E 024F C2BF C2BE 04ACI 04AC0 
003C84 0227 C2BF C04F 04AC1 0S551 



400 OUT CANCEL 

405 *«*«*««**«**«««*«**««*«**«**4i«««*«****««Mi««4i4i**«**«««**«««««***«*****« 

406 *LaaP TINER ROUTINE* 

40T •***•«•*«*««•«**««•••«**««*«****«•••*••«*«•««•*••«••*••««*•••«•*••«•**« 

408 TININTR MVC BUCSWARN>BU6SUARN-1 

409 NVC BU6SWARN(40)tCHKPTURN 

410 PUT TVPOUTl 

415 POUMP L00PCNT,L00PCNT4^3 DUMP LOCATIONS USED AS COUNTER 

420 * FOR THE LOOP AT EACH TIMER INT. 

421 EXIT IT 

424 ***«««**4i«***««******«****«***«****«****************«******«*****«**«** 

425 »END OF LOOP ROUTINE* 

426 *********************************************************************** 



(,£'xf3j. 



This source code listing shows the PDUMP macro where the programmer needed 
to know the contents of an area used as a counter. 



o 



The following dump printout was obtained when the program was executed. 








IT 




KENTOMSl 12/06/T3 




PAGE 


1 




r 


GR 0-7 
GR 8-F 
FP REG 
CR 0-7 
CR e-F 

041680 


00041E10 00041E08 00000049 00000000 
00000001 0000CA34 00000013 4004007A 
00000000 00000000 00000000 00000000 
004000FF 0000E640 FFFFFFFF FFFFFFFF 
OOOOFFFF 00000000 00000000 00000000 


00000000 00000050 00000010 00000002 
0004107A 07C8C16? 8004050E 000422F8 
00000000 00000000 00000000 OOOOOQOO 
00000000 00000000 00000000 OOOOOOOO 
0000.000 OOOOOOOO C2000000 00000200 

00000*34 




" (£''/<'A7i 




111 










mi 





Restriction: 

The message INVALID ADDRESS SPACE is printed on the dump output if the 
dump includes storage areas considered to be invalid address space. 

The definition of invalid address space is listed under "Restrictions" in the 
description of the ALTER command. 
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Dumps of, and changes to Real and Virtual Address Areas 

DUMP macro 



SUPERVISOR 

COMMUNICATION 

MACROS 



This macro, when assembled into your program and executed, will dump the 
following system information: 

• The general registers 

• The floating point registers (if FP is supported) 

• The control registers 

• The active communication region address (see Section 4 for a description) 

• The supervisor 

• The PD area (if PD is specified for the system; see B-3 in this Section) 

• The label length 

• The partition identifier BG, Fl, F2, etc. 

• The temporary real or virtual partition issuing the macro. 






Name 
(name) 


Operation 
DUMP 


Operand 



If the program or main task issued the macro, the job step is terminated. 

If DUMP=PART was specified in the STDJC macro at system generation time, 
not all of the above information will be dumped. Of the active communication 
region address, the supervisor, and the PD area, only the addresses and contents 
of the following supervisor control blocks will be printed: 

— partition communication region 

- PUB table 

- PUBOWNER table 

— partition LUB table 

- JIB table 

— partition DIB table. 

The specification in the STDJC macro can be overruled by the // OPTION 
statement. Refer to System Dump in this section. 

JDUMP macro 



v_.y 



Name 
(name) 


Operation 
JDUiViP 


Operand 



If the program or main task issued the macro, the main task (the whole job) is 
terminated or a dump is made of those areas listed in the description of the 
DUMP macro. , 



..> 



2.38 Serviceability Aids 



Dumps of, and changes to Real and Virtual Address Areas 



The following considerations apply to both the DUMP and JDUMP macros: 

1. If a subtask issues these macros, the subtask is detached, the job step or job, 
respectively, is not terminated, and the dump described above is executed. 

2. The dump is always provide)! on SYSLST, which may be a printer, tape, or 
disk. 

3. If either macro is issued by a program running in real mode, the temporary 
real partition is dumped. However, if these macros are issued by a program 
running in virtual mode, the whole virtual partition is dumped. 

4. The dump output can be either standard or translated, depending on the type 
of dump cataloged into your system during system generation. 

5. The LTA (Logical Transient Area) is used to contain the dump program; 
therefore, the LTA printed in the dump will always contain a B-transient 
$$BDUMPB (if the dump is directed to a line printer or tape unit), or 
$$BDMPDC (if the dump is directed to a disk drive). 



SUPERVISOR 

COMMUNICATION 

MACROS 



o 



When to use 

By coding these macros into your source listing you can ensure that a dump of 
the supervisor and of the partition issuing the macro is executed. 

For example, you may require a partition dump when certain conditions arise 
during program execution. This is accompHshed by programming a branch to 
the DUMP (or JDUMP) macro written in the source listing. The JDUMP 
macro must be used when it is necessary to terminate the job after entering the 
routine that issued the macro. The DUMP macro is used when termination only of 
the job step is required, for example, during program testing. After termination of 
the job step in which the macro was issued the job steps after that are still 
executed. 
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2.42 Serviceability Aids 



Two series of trace routines are provided on the System/370: 
SDAIDS. 
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These aids enable information to be obtained from the system at the time of a 
malfunction. They are aids for further error isolation, and are usually initiated 
during a rerun of a troublesome program after a first analysis of the problem. 
The type of trace to use for a particular problem depends on the result of the 
first analysis and how much more information is required to help in further 
isolation of the error. 

This section is divided into two parts: 

Part 1 describes the PDAIDS, and part 2 describes the SDAIDS. 

PART 1 PDAIDS 

General description 

There are seven trace routines that can produce printed output of certain events 
which occur during the execution of programs. 

The trace routine will: 

• Record I/O operations (I/O trace) 

• Record the order in which phases and transients are called (Fetch/Load trace) 

• Record the order in which supervisor calls (SVCs) are executed (Generalized 
SVC trace) 

• Record the order in which either an SVC or an SVC 3 1 , and I/O 
interrupts occur. (QTAM trace), 

• Record the order in which either an SVC 49 or an SVC 53, and I/O 
interrupts occur (VT AM trace). 

• Record per pool the maximum number of buffers used, queued, and in use. 
In addition, if networking (ACF/VTAM) is used, record the number of 
pool expansions, the maximum number of buffers, and the number of 
buffers currently available (VTAM Buffer Pool Trace). 

• Dump the PTA and LTA when a program check occurs in a transient routine 
(Transient Dump). 

On the occurrence of an event, an entry is generated which, by selection of the 
trace, can be recorded on magnetic tape, printed on a line printer, or preserved 
either in the PD area or, if specified, in an alternate area of real storage. 

Caution 

The effect on the operation of programs currently running in the system 
that are time dependent, for example, a program using MICR or teleprocessing 
as input/output, must be considered before using this serviceability aid. 
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System requirements 

Before any PDAID function can be executed, the following requirements must 
be met: 

• During the system generation, specify a minimum value of 1400 in the PD 
parameter of the FOPT macro. (The maximum value is 10,240). 

• If data provided by the trace routines is recorded on magnetic tape, use 
the PDLIST program after tracing is complete to obtain a printout of the 
tape. 

All PDAID modules are distributed by IBM in the core image library. 
They are self-relocating for initialization in any real or virtual partition 
(6K or greater) of a multiprogramming system. 

Restrictions: More than one PDAID trace routine cannot operate concurrently. 
This also applies to the PDAID Transient Dump program described in Section 
2-A-4. Therefore, more than one program rerun must be executed if more than 
one PDAID function is used to gather information about a failing program. 

Using PDAID and SDAID concurrently: If SDAID is active it must first be 
terminated before initiating a PDAID trace in core-wrap output mode in an 
altemate area. 






Modes of output 

Line printer: (not available as output mode for QTAM or VTAM trace), Examples 
in this section show the trace outputs when the output device is a line printer. An 
asterisk on the print-out indicates that at least one event (trace entry) has been 
overwritten. This occurs when an overflow is caused in the trace table in the 
PD area (described in B-3) or in an alternate area. This may occur when the trace 
output device, or its control unit, or channel, is shared with other programs 
running simultaneously. 

If the printer is not ready or has an error condition, message 4C24A NO I/O TO 00 
is printed on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the printer is made READY. 

Magnetic tape: This mode of output collects and writes on an unlabeled tape the 
trace entries that occur during execution of a job stream. 

The events are written on tape in core image (unprintable) format. 

The tape must be processed using the PDLIST utility. The tape unit must be 
assigned temporarily or permanently to SYS005 and SYSLST assigned temporarily 
or permanently to a line printer in order to obtain readable listings of the events 
traced. Examples in this section show the output format after using the PDLIST 
utiHty. 

If the tape unit is not ready or has an error condition the message 

4C24ANOI/OTOOD 

is issued on SYSLOG and the system waits for the END/ENTER key to be 
pressed after the tape drive is made READY. 
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Trace Routines 

Core-wrap: This mode of output preserves a fixed number of trace entries in either PD Al DS 

the PD area buffer or an alternate area taken from the main page pool. If the 
alternate area is specified, the PD area buffer is not used. When the area is full, the 
oldest entry is overwritten by each new entry. 

When core-wrap in the PD area is specified, the PD area must be dumped. The 
dump should normally be executed on the occurrence of a system malfunction 
when the last few trace event entries are required to aid offline debugging. 
Dumping and locating the PD area is described under B-3 in this section. 

Table B-3 lists the length of each type of trace entry, the locations, and the 
maximum number of entries that can be preserved in the minimum PD area 
buffer size. Use the table and a dump of the PD area to locate the oldest and 
newest trace entries. 

Core-wrap in an alternate area: If many events are to be recorded in the core- 
wrap output mode and the PD area is considered to be too small, specify an 
alternate area large enough to contain the trace event entries. 

Specifying and dumping an alternate area is described under B-4 in this section. 

When an alternate area is specified, the real storage taken from the main page pool 
is returned to the main page pool on termination of PDAIDS, Before the alternate 
area is released, its contents are dumped on the device assigned to SYSLST. 
(See "Termination of PDAIDS,") 

When to use the core-wrap output mode: This output mode is useful when no 
output device is available, or when time required by the output operation is not 
available. This would be the case for example, when aPDAID output device 
interferes with time-dependent programs example, when a PDAID output device 
interferes with time-dependent programs using the I/O channels. It should also be 
specified when only the last few trace event entries are necessary to aid in offline 
debugging. (This reduces the task of searching through masses of output.) 

Termina ting PDA IDS 

Any trace routine can be terminated by re-initializing the PDAID program with 
the job control statement // EXEC PDAID, and responding to the message 
PDAID= with XX. It is also possible to reset (terminate) one trace routine by 
loading another. 

Terminating core-wrap output in an alternate area 

When the core-wrap output is selected, SYSLST must be assigned to either a 
line printer, a tape unit, or a disk drive, before responding with XX to the 
message 4C10D PDA I D=. 

For example: 

f/ASSGN SYSLST, X'OOE' 
//EXEC PDAID 

If SYSLST is unassigned, the contents of the alternate area is overwritten when it is 

returned to the main page pool. 

PDLIST 

Whether the PDAID function uses a printer for its output device, or the PDLIST 

program prints the output of a tape unit, the data printed out is identical, 

PDLIST is initiated by the command: 

//EXEC PDLIST 

PDLIST then prints on SYSLST the contents of the tape reel (it can include the 

output of more than one PDAID function) mounted on SYS005. No tape labels 

are required. 

Note: The data can only be printed using PDLIST if the device assigned to 
SYSLST is a line printer. 
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Description and operation 



Input/Output Trace 

This trace enables the I/O activity of programs run under DOS/VS to be recorded 
for offline analysis. The format of the data recorded in the PD area either in a 
trace table or, when using the core-wrap output mode in a rotating buffer, is as 
follows: 

Length of one entry = 18 decimal bytes i 



'K.J 



On the occurrence of an I/O interrupt; 

1 — I — r~ 



Device 
Ad<ilr 



"I — I — r 

I/O OLD PS W 
J I \ I 



1 — r 

CSW 



On the occurrence of a START I/O instruction 



n 

E2 40 



Device 



-n — I — I — 

CCB ADDR-R1 



1 — I — r 

CSW 



J L 



I I I 



— Condition Code 

If the entry is made due to CSW stored 
on a START I/O instruction the CCW 
address in the CSW is set to zero. 

Notes: 

1. The PS W and CSW are described in E-2 of this Section. 

2. The CCB is described in chapter 6 of Section 4. 

3. General purpose register usage is described in chapter 10 of Section 4. 

4. The CCB address and the CCW address in the CSW are virtual addresses. 

Either of these occurrences is referred to as an I/O event. 

By selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 
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Tracing Options: The I/O trace function provides the following options: 

• Trace all I/O activity on the system. 

• Eliminate a maximum of three devices. 

• Limit trace to a maximum of three devices. 

The trace limiting options are specified by the initializer keywords IGNORE 
DEVICE= or TRACE DEVICE=. All I/O activity is traced if one of these key- 
words is not specified. The two keywords are mutually exclusive: when one is 
specified, the other becomes invalid. 

The trace limiting options are invoked by specifying the channel and unit 
addresses (X'cuu' or cuu) of the appropriate devices. Symbolic device 
references (SYSxxx) are invalid. 

Note: If the trace output device is being used by a problem or control program 
simultaneously with the PDA ID program, I/O events for the PDAID program 
are ignored (not traced). Because of this, it is not necessary to ignore the trace 
output device. 

When to use: Use the I/O trace to check that the I/O interrupts within your 
system are correct during the execution of programs. 

You could use it, for example, in a multiprogramming system where the status 
of I/O units is suspected of causing incorrect I/O interrupts. An I/O trace output 
will inform you about the sequence of SIO/ I/O interrupts and about the 
status of I/O units at the time of interrupt. 

The next two examples show the output obtained from an I/O trace. 
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OOE 070C20000000090C 
OOE 070C200000P0090C 
OOE 070C2000000009DC 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070F20000000090C 
OOE 070C20000000090C 
OOE 070F20000000090C 



1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
1004094008000000 
0000000004000000 
0000000004000000 
0000000004000000 
0000000004000000 
0000000004000000 
0000000004000000 



OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070C20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F20000000090C 0000000004000000 
OOE 070F. ^-n^fZ^ o^ce. ^ 104000000 
SIO 00005/-^ <;;t4,^Sc<^^ '08000000 
SIO OOOOi ^.--■'''^'^■^H^ 104000000 
/^O OOOOi J04000(5t»)> 



SIO OOOOOOOE00040910 0000000004000000 
SIO 0O00OOOEO004091O 0000000004000000 
SIO OOOOOOOE"—'""'" '<''""'"'0004000000 

SIO 0000000 E ^^v«<:t- e^^ .— -- 

SIO oooooooe/*** ^/o <»t/cf^uM' fMym. 



SIO O00000OE00040910 0000000004000000 



SIO OOOOOOOE00040910 0000000004000000 
SiO 0O0000OEO0040910 0000000004000000 
SIO OOOOOOOE00040910 0000000004000000 



(Ai/^ctjl, a/dZf 



■^ 



381 070C20000000090C 1004088800000000 



OOE 070C20000000090C 1004094008000000 ] 

OOE 070C20000000090C 1004094008000000 / J^tJ^!^ 

OOE 070C20000000090C X 004094008000000 V. -frvtn 

OOE 070C20000000090C 1004094008000000 [ OO E ' 

OOE 070C20000000090C 1004094008000000 j 

OOE 070C20000000090C 1004094008000000 '' (git /g /fr)\ 



An example showing an I/O trace output printed on a line printer used as the 
PDAID output device. 



PDAREA 

OO'S'tSO 
009410 
009<.C0 
0094E0 
009 500 
003520 
009 540 
009 550 
009580 
009 5A0 
0095C0 
0095EO 
009600 
009 520 
009640 
039550 
009680 
009 5A0 
009 5!; 
0095EO 
009 700 
009720 
009740 
C09760 
009780 
0097A0 
009 7:0 
0097EO 
009 800 
009820 
039840 
009 860 
009880 
0098A0 
009 SCO 
0098EO 
009900 
009920 
009940 
009950 
039980 

00994 
0099^0 

00995 



804000EO OOOOF500 FFFFFFFF FFFFFFFF 
00005300 00000000 00000000 00000000 



00000000 00000000 
00000030 00000000 



00003000 00000000 
:2000000 00000200 



E3037;F3 F8F07000 1000099FF D000479C 303015BE OOQ0B44E 

00003300 00004798 33003AA4 0OOO1330 ^D7:'t:iC9 C4C9E3E5 

FFFFFFFF FFFFFFFF FFFFFFFF 3 FP /^ 
FFFFF 

50C09.^, ^„„ , ^ .,. ,, 

47F09084 95FFA002 4733910C 1B( ^ / V ■ 
00004111 000058:0 91C4912 
58B10020 19AB4740 90FE41C 

e003*7f:0 910CBFB7 80454770 93[ 

078A070A 49209038 078A070A 49: 

07843501 B00691C8 078A58B0 91B8418B 

916307=4 58B091B8 44009058 502B0002 

0018*248 00029430 B0029120 10054710 

47F09110 58A1001C 50AB0005 913DB332 

00009924 000099FC C4E4D400 00002330 

84F30333 OOOOOOOE 070F2333 33333962 

84FO0OOO 00000400 OOOOOOOE 07OC2000 

20003000 09620000 00000400 0OOOE24O 

ooo;o7x ynncnono 09620000 BAFOoaon 



=FFF FFFFFFFF FFFFFFFF 3 FP /^ , 

= = 80 800047AE 47F0915C 581 CfT,/- ^ ^/^^^jr/ 
nC4 58A00014 48AOA040 49: JW^ ^ ^ «^»'*'<*«'*» 

20 101 /y^/a/isi. "/o'.^i^ 

CB 00' / 



001259BO 91Bt4743 
501B0005 D2O1B00O 
919C9130 B0024773 
47839192 47F090C4 
D5E7FFFF 000E070C 
30300030 040J 
O34rrT5I500 8 A F 
303E FF0O8AF0 
033303E 07PF2000 



oooflnr.'ift. 

ffFFD009 
"FFFFFFF 
S03000BA 
► 780§10C 
I0805AC0 
1FA70041 
I03C58B0 
■.8A0905C 
101CJ502 
915558B0 
91B350A3 
91130702 
E2400000 
20000000 



iiaaa?F02 

ffffI 
ffffffff 

50A0905C 
41AA0008 
A024581: 
47809U0 
91B8BEA7 
49239035 
B00391CO 
91B450B0 
905:88A0 
B00B800B 
00009654 
09620000 



04000000 [E2400000 OOOEFFOO 6AF00300 00000430 OOO0 P3OE 



00333000 04000003 
00003962 00030000 
070C2000 00000952 



000- 
070 "^ 



— Cb^^' 



"^^ 



2/c o^^f■-- ^ 









080- 
000 
000 
070 



000000 096:;uud'o ooouu4oo 0000E240 



3E070C 20300000 
300300 E2430300 
008AFO 08000000 



OOOOzi^'J UOOOUOOt FF008AF0 00033330 
84F33300 OOOOOOOE 073F?000 30300952 
8AF00O0O 00000400 OOOOOOOE 070C2000 
20003000 09620000 00000400 30O0E2*O 
000;070: 20000000 09520003 8AF00830 
04003000 E2400000 OOOEFFOO 8AFOO30O 
000034=0 08000000 O00EO7OF 20000300 
FFO084=O 00000000 04000000 000E070C 
070F2000 00000952 00000000 34030330 
0000300: 07OC2O0O 00000952 30308AF0 
00000400 00O0E240 OOOOOOOE FF008AFO 
09520000 8AF00800 OOOOOOOE O70F200O 



09523030 8AF00800 
OOOlFFOO SAFOOOOO 
000E073F 20000000 
04000000 000E07ac 
30303330 04000030 
03000952 00008AFO 
OOOOOOOE FF008AFO 
0030003E 070F2000 
30303400 OOOOOOOE 
09523000 00000400 
20300330 09620033 
E2400000 OOOEFFOO 
08000000 OO0EO7OF 
00303030 04000000 
00300952 00000000 



04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
09520000 
20000000 
E2400000 
08000000 
00000000 
00000952 
070C2000 
0000=240 
8AF0080O 
8AFOOOO0 
20003000 
ObOE070C 
04000000 



OOOE070: 
04000000 
0000 8AF0 
FFOOBAFO 
070F2000 
OOOOOOOE 
00000400 
0962 0000 
OOOEFFOO 
OOOE070F 
04000000 
00000000 
00000962 
OOOOOOOE 
OOOOOOOE 
00000400 
0962 0000 
20000000 
00000000 



^/ O Cfxt<Ji^ on. Mr^ ^ 

<^ /^ o o ^a^ , 

TL.380 *. 

.... ^POAIDITWt 

'..W. ^/O Cn^^ji^ - cm.^UCC \ \ 

..N....h #. 

#. .. «...K #..*.. 

P 

.0 * 0..S 

DUM NX 



V, 



.> 



An example of an I/O trace executed in core-wrap output mode in the PD area. The 
PD area was dumped using the DUMP command. 
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Fetch /Load trace 

The F/L (fetch/load) trace records the order in which phases and transients are 
called from the core image library under the control of DOS/ VS. Issuing a fetch 
or load causes an SVC 1 , 2, 4, or 65, and the format of data recorded is as follows: 

^ Length of one entry = 22 decinnal bytes ^ 
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PHASE NAME 

J I I I I 



SVC 
No. 



SVC ADDR 

I \ 



LOAD ADDR 



ENTRY ADDR 



JYstoG 



►-AR, BG, Fn 
See note 4. 

. Entry address to give 
control to the phase. 
(See note 5) 




.^ Address at which 
the phase is loaded. 
(See note 5) 
Call Address (This is taken from 
the SVC old PSW; therefore it is 
actually 2 bytes past the calling 
address.) 



Value of the Supervisor Call (See note 3) 



Phase Name 



Notes: 

1. At times, SVC 5, 6, 11, and 14 branch directly into the supervisor fetch or 
load routine. These are traced whenever they occur, and appear in the 
output of the trace; however, the calling address and SVC values do not 
indicate the actual fetch or load. 

2. Use of the REQUEST key during the operation of the F/L trace may result 
in apparently erroneous data due to the supervisor action required to 
handle the request. 

In particular, supervisor calls that have already been recorded may not be 
completed, and part of the data put out by the specific phase may pertain 
to these incomplete SVCs. 

3. A list of DOS I VS SVCs can be found in Section 4. 

4. The SYSLOG ID is described in appendix B. Fn can be Fl up to the 
highest numbered foreground partition available in the system. 

3. The load address and entry address for a phase in SVA shows 'INSVA ' when 
the output device is a line printer or tape unit, and 'SVA PHASE' in 
core-wrap-mode. 

When the trace is recorded on tape and PDLIST is used to print the tape, 
the two bytes used for the SYSLOG ID are printed between SVC ADDR 
and the LOAD ADDR. 
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On the occurrence of an event, an entry is generated. By selection of the trace 
output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 

Tracing Options: The F/L trace functions are: 

• Trace all SVC 1 , 2, 4 , 65 , and certain SVC 5 , 6, 11 , and 14 interruptions. 

• Limit the trace by partition (multiprogramming systems only). 

Trace limiting options are specified by the initializer keyword TRACE PARTITION= 

These options are useful only when the user runs several partitions at once, and does 
not wish to trace all of them. If only one partition is operating at a given time, the 
default (trace all partitions) allows both the single partition and the supervisor to 
be traced. 

When to use: Use the F/L trace if you are not certain which phases are required 
for a particular program, or in which sequence they are called by the program. 
From the trace output you can see where the phases were loaded and their 
entry addresses. In addition you can check the logical use of the phases for the 
program. 

The next two examples show the output obtained from an F/L trace. 






X...J^' 
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HHHHHH 












1 // JOB POL I ST 
^ NAP 
* // ASSGN SVSOOS.X'Zi 

// NTC REM.SYSOOS 
^ 1 // EXEC POLIST 




DATE 12/06/73,CL0CK 


20/31/54 






a* 




^Z ^fO^ ffrt J8<i jir/ 












^ yvut. u*^ p^So/^V 






^ I //BCLOSE 2 C-040MA 
! //BEOJ} E C-040B4C 


B6 L-00aZE8 E-0082F0 
BG L-0082E8 E-0082E8 


//BCL0S2 2 C-008406 BG L-0082E8 E-0082F0 
//8Epj4 2 C-00837C BG L-0082E8 E-0082F0 


6" ^ ^ a^ PM/sr. 






^ 1 fneOJT 2 C-008«BA 


B6 L-0082E8 E^0082F0 


//BEOJ 2 C-008372 BG L-0082E8 E-0082F0 






^ 1 //BEOJSl 2 C-00847A 


BG L-0082E8 E-0082FO 


/JOBCTLA 4 C-00839E BG L-040078 E-041888 








/J0BCTL6 4 C-04095a 
• 1 /JOBACCT ♦ G-041AE0 


BG L-041888 E-041888 
BG L-Q41B80 E-041B80 


fJOBCTLN 4 C-040958 BG L-041888 E-041888 
/JOBCTLG 4 C-040958 BG L-041888 £-041888 y^ 






^ /JOeCTLF 4 C-040958 
! /J08CTLJ * C-040958 


BG L-041888 E-041888 
BG L-041888 E-041888 


/JOaCTLG 4 C-Q40958 BG L-041888 E-041888 ^ 


(Ex 17 Kt) 




If/BOPEN 2 C-040B42 BG L-0082E8 E-0082F0 1 




HHHH 






^^^^^^^^^ 






An example showing an F/L trace output as printed on a line printer using 
PDliST. (A tape unit was selected as output device for the PDAID.) 



o 



# 






-P.O,- 
009*80 
0094AO 
009 4C0 
0094E0 
009500 
009 520 
009540 
009560 
009580 
0095A0 
009 5C0 
0095E0 
009 600 
009620 
009640 
009660 
009680 
0096A0 
009 6C0 
009 6E0 
009700 
00972 
009740 
009760 
009780 
C097A0 
O097C0 
0097E0 
009800 
009820 
009 840 
009 860 
009 880 
009840 
009 SCO 
009 8E0 
009900 
009920 
009940 
009960 
009980 
0099A0 
0099C0 
0099e0 

LBLTYP 
-=2~ 
OBIOOO 
091020 
091040 



0EBUGEX3 ^ \QIQ5m 



00000330 ~SAME~ 
00000000 00000000 00000000 

,«,, 5^W^/ "/-/'/' ^/^ 

PV a^Mei C5000B9FB 0000479C 
00000000 00006940 00003Ttf4 00001003 
90ECD202 B0090025 02008008 008B07FA 
FFFFFF30 FFFFFFFF 07FA070A 07FA070A 
4710909A 95FF90F5 078A95FF 90F5078A 
078A59B0 90eC501B OOOC500B 00100207 
0201B014 80029502 B0084770 90CE4111 
90F04740 90E258B0 90E8SOBO 90EC07FA 
FFFFFFFF 5B5BC2C5 D6D1F340 OB008908 
F4400200 88860000 87CO0O0O 87C8C6F2 
000087^8 C6F25B5B C2C5D6D1 F4400200 
0601F540 02008704 000087CO 000087C8 
87CO000O 87C8C6F2 5B5BC2C5 D6D1F540 
C2C50i31 F4400200 881A0O00 87COOO00 
000087C0 000087C8 C6F25B5B C2C5D6D1 
5B5BC2:5 06D1F540 02008704 000087CO 
881A00OO 87COOO00 87C8C6F2 5B5BC2C5 
C6F25B5B C2C5D601 F4400200 881AOOO0 
02008996 000087C0 000087C8 C6F2SB5B 
87C8C6F2 5B58C2D7 C3C8D240 02O08A3E 
D7400200 a94 Cfl0Q0 87CO0OO0 87C8C6F2 
000087C8 C6F2 |5B5B C2C4D4D7 C2C30200 
D7C5D540 
87C 00330 
C20604=3 
000087C0 
5B5B:236 
89EE0900 
C6F25B5B 
02008432 

87C8!;SF2 bB58L2C3 D306E2C5 02008A90 
054O020B 12C20000 87C00000 87C8C6F2 
000087C8 C6F25B5B C2D607C9 C7D50400 
04E3F3=5 020089EE 000087CO 000087C8 
87COO000 87C8C6F2 5B5BC2D6 D7C5D5F1 
C2C3:536 E5F1020B 31 5A000n 87C0OO00 
00OO87:0 000087C8 C6F25B5fa C2C3D3D6 
5B5B:2;3 D3D6E2F2 020C89CE 000087CO 
8AO2O300 87C00000 87C8C6F2 585BC2C3 
C6F2535B C2C303D6 E2C50200 8A90000a 
020B17D2 000087CO 000087C8 C6F25B5B 
87C8C6F2 5B5BC2D6 D7C9C705 04008946 
FOF5O20O 89EEO0O0 87C00000 87C8C6F2 
000087C8 C6F25B5B C2D6D7C5 D5F102O0 



Cne/ CUK^"^^ y^ 



300 00000000 00000000 , 



4E^ooac 

iMFFFf 




0000168E OO0OB44Ef OO0OOC56 00009F02 

ID7:4C1C9 C4C6E3E6T FFFF0009 FFFF5860 

FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 

47F09036 428090F5 58800080 91018042 

95FF90F5 078A95FF 90F5078A 95FF90F5 

B0005030 58800014 4880805A 4A8090F4 

0008501B 0010581B 000C41BB 001659BO 

00009584 0000973C 000099FC 0040FFFF 

000087CO 000087C3 C6F25BSB C2C506D1 

5B5BC2C5 0601F540 020087D4 000087CO 

881AOO0O 87C00000 87C8:6F2 5B5BC2C5 

C6F25B5B C2C5D6D1 F4400200 881AOO0O 

020087D4 000087CO 000087C8 C6F2 5B5B 

87C8C6F2 5B5BC2C;5 D6D1F540 02008704 

F44OO20O 881A0000 87C0O0O0 87C8C6F2 

000087C8 C6F25B5B C2C5D6D1 F44OO200 

D601F540 02008704 000087r" nnnnoTro^ ___ 

87C0OOOO 87C8C6F2 5B5BC2 Q.f^. U^e^cX, €>rtSZ^ 

C2C5D6D1 40400200 885E00 - /"o -» i /~ \ <7^ 

000087CO 000087C8 C6F25B f '^^ -C PaC*^ ) 

5B5BC2C4 E4D4D7C2 02008AA(y 000087C0 

88EE0000 8 7COOO00 87C8:6£il 5B5BC2D6 




.K. 



.0. .S...Y* 

....a&BE0J3 .... 

4 HF2 

.•.HF2t£BE0J4 .. 

0J5 ...M H 

HF2£tBE0J5 

BE0J4 

HF2e(;BE0J 

&&BE0J5 ...H.... 
HF2t£BE 



, HF2C(; 



... ....\..HF2 

HF2 fc£B0MPBC.. 



F2E,ilBE0J 

&CBE0J5 ...M.... 

HF2S&BE 

F2&SBE0J4 

...M HF2<;i; 

.HF2e;£BEOJ5 ...M 

4 HF2 

.•.HF2££BE0J4 .. 

0J5 ...M H 

HF2CEBE0J7 

BEOJ 

HF2££BDUM 

CtBDJMPB .... .... 

IH13£6B0 






tn^ 



^^^ ^^ AcL 






PEN M F2(1£B0PEN1. 

HF2££B0PIGN F2££ 



D306E2F3 
87COOO0O 
000087CO 000087C8 C6F25B5B C20607C5 
5B5BC2D6 07C5D5F1 02008862 000087CO 
89460000 87C0000O 87C0C6F2 5B5BC2D6 
C6F25B5B C2D6D7C5 05400200 89220000 
02008862 000087C0 000087C8 C6F25B5B 
87C8C6F2 5B5BC2C3 04E3F0F1 02008986 
E2C5020B 17C20000 87COO000 87C8C6F2 
000087C8 C6F25B5B C2C3D3D5 E2F30200 
D4E3F0F5 02008882 000O87C0 000087C8 
87CO0OOO 87C8C6F2 5B5BC2D6 D7CS0540 
C2D6D7C5 D5F1O2O0 88620000 87C00000 
000087CO OO0C87C0 C6F25B5B C2060463 
5B5BC2D6 D7C5D540 02008922 000087C0 
88620000 87C00O00 87CSC6F2 00000000 



B0HT05 

HF2&£B0PE 

£(;B3PIGN 

HF2££BC 

F2££BCL3S2 

...< HF2e& 

.HF2G.£eCL0SE.... 

N ...B HF2 

...HF2££60PIGN.. 
HT05 ,....H 



.HF2Ce,aOPEN .... 

Nl HF2 

....F2(;CBOUR01.. 

LOSE H 

HF2e£BCL0S3 

3CMT05 

HF2e&B0PE 

CSBOPENl 

F2&£B0 

F2££BaPEN 



HF2£(1B0PEN1 HF2££ 

BCEDtri HF2££BCMT01.... 

HF2££BCL0 SE...B HF2 



££B:L0S2 

.K HF2££BC 

F2££BCL0SE 

...<.......HF2££ 

.HF2££B0PIQN.... 

05 HF2 

...HF2££B0PEN1.. 



...HF2££BCL0S3.. 

MT05 H 

HF2££B0PEN 

BOPENl 

F2££B0MT 

£CBOPEN 

HF2.... 



HEX LSSGTH IS 0000 

£7C8C1E2 C55C5C5C 074D3000 000B1718 
D7C8CIE2 A00B16EE 000B32A8 OOOOOOIB 
00000033 00000000 00000000 00000000 



00000000 00000000 403B107A OO032O7A 
0O0B1910 00000049 00003002 0000002E 
00008450 5E0E6CAF 00000000 OOOOOOOO 



PHASE***. 
PHAS 



m 



An example showing the PD area in a system dump after executing the F/L trace 
in core-wrap output mode in the PD area. 



Serviceability Aids 2.51 



Trace Routines 

PDAIDS 



Generalized Supervisor Call trace 

The GSVC trace records SVC interrupts as they occur. All SVCs, or a selected 
group of SVCs, may be traced. The format of the data recorded in the PD area 
either in a trace table or, when using the core-wrap output mode, in a rotating 
buffer, is as follows; 



1. 



'>^, 



Length of one entry = 1 8 decimal bytes 



ill 1 1 1 1 

SVC OLD PSW 

III 1 1 1 1 . 


1 • 1 
GRO 

1 1 1 


SVC 
No. 


t 1 
GR1 

1 1 


SYSLOG 
ID* 



AR 
BG 
Fn 



— (See note 5j 



The contents of general purpose register 1 



Value of the Supervisor Call, (See note 3.) 



->' The contents of general purpose register 0. 



Notes: 

1. If PTO=YES in the FOPT macro, then SVCs issued when the physical 
transient area is busy are not traced. 

2. The PSW is described in E-2 of this Section. 

3. A list of DOS I VS SVCs can be found in Section 4. 

4. General purpose register usage is described in Section 4. 

5. The SYSLOG ID is described in appendix B. Fn can be Fl up to the 
highest numbered foreground partition available in the system. 



K. 



X«|l»'' 



2.52 Serviceabihty Aids 



o 



On the occurrence of an event, an entry is generated. By selection of the trace 
output device, the event can be: 

• Recorded on magnetic tape 

• Printed on a line printer 

• Preserved in the PD area 

• Preserved in an alternate area. 

When the magnetic tape output is used, the tape must be processed by the 
PDUST utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 
Tracing Options: The GSVC function provides the following options: 



Trace Routines 

PDAIDS 



Trace all SVCs that occur. 

Trace up to six SVCs selectively. 

Eliminate up to six SVCs selectively, and trace all others. 

Trace all partitions. 

Trace one or more partitions selectively. 




SVC limiting options are specified by the initializer keywords IGNORE SVC= 
or TRACE SVC=. All SVC activity is traced if one of these option keywords is 
not specified. The two keywords are mutually exclusive: when one is specified, 
the other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION=. This is useful only when the user must run several partitions at 
once, and does not wish to trace all of them. 

When reading the output from this trace routine you may see more SVCs Hsted 
than expected. This is because an SVC already traced and recorded may be reset by 
the supervisor SVC routine, and then re-issued by the program being traced. For 
example, your program may issue an SVC 0, which is traced. But the channel 
queue may be full at that point in time, and so the supervisor can not handle the 
SVC 0. When your program has control again it will issue the SVC which will of 
course be traced again. 

When to use: Use the GSVC trace when a particular SVC issued by a troublesome 
program is suspected of causing the errors. 

The values of registers and 1 are printed on the trace output and these can be 
important for certain SVCs. 

The trace output also shows the current PSW at the time the SVC was issued. 
Therefore, the instruction and routine issuing the SVC in the program can be 
located. 

.The next two examples show the output obtained from a GSVC trace. 



Serviceability Aids 2.53 



Trace Routines 

PDA IDS 



// ASSGN SyS005,X'2Al' ^ ^^ 

// MTC «EW,SYS005 jf / er , t: /> n( /" ^^<^Tl 

II EXEC POLJST ^SVC <^ rSW 9^1'' ^ '' ^ 

[pSWHOTOD1000000083I6ro^000092COri^g00092CO|dr^(T- BplfrPSW-07ID2000000»OB4A 0-00040B44 1-000A1508 N-02 T-BG 

PSW-070D10000000831C 0-00040B'f4 I-000004AO N-21 T-BG PSW-070D000000008484 0-00040B44 1-00041A88 M-1* T-BG 

PSM-070D0000000084D6 0-00040844 1-000082E8 N-02 T-BG | PSW-07aD000000008304 0-C0040B44 1-000004AO N-21 T-BG | 

PSW-070D000000008422 0-00040B44 1-000004AO N-OB T-BG PSW-071D200000040B4C 0-00040844 1-00041488 N-OE T-BG 

PSM-O70DOO000O0082FC 0-00040B44 1-000004AO N-21 T-BG PSW-070000000000837C 0-00040B44 1-000082E8 N-02 T-BG 

PSW-070D000000008306 0-00040B44 1-000004A0 N-21 T-BG P$W-070D2000000084BA 0-00040B40 1-000082E8 N-02 T-BG 



5/0 X'tf' 



"J8^ 



An example showing a GSVC trace output as printed on a line printer using PDLIST. 
(A tape unit was selected as output device for the PDAID.) 



03F980 
03F9AO 
03F9C0 
03F9E0 
03FA00 
03FA20 
03FA40 
03FA60 
03FA80 
03FAA0 
03FAC0 
03FAE0 
03FB00 
03FB20 
03FB40 
03Fe60 
03FB80 
03F8A0 
03FBCO 
03FBE0 
03FC00 
03FC20 
03FC40 
03FC60 
03FC80 
03FCA0 
03FCCO 
03FCE0 
O3FDO0 
03FD20 
03FD40 
03FD60 
03FD80 
03F0A0 
03F0C0 
03FDE0 
03FEOO 
03FE20 
03FE40 
03FE60 
03FE80 
03FEA0 

o»i;«co-- 

03FEE0 
03FF00 
03FF20 
03FF40 
03FF60 
03FF80 
03FFA0 
03FFC0 
03FFE0 



TERMTOHS 

22560000 
00000004 
C2C7071D 
00040808 
00040CA9 
000422EE 
071D3000 
0910C2C7 
OOOB0704 
22DC0OOO 
00000004 
C2C70710 
070408D8 
00040CA9 
00042256 
O71D00O0 
0820C2C7 
0CA90004 
22C40000 
00000004 
C2C70710 
00040910 
000000 IB 
000422EE 
O71D00O0 
08D8C2C7 
0CA90O04 
Z24C0004 
30000004 
C2C7071D 
07040910 
OOOOOOOB 
000422C4 
07100000 
0910C2C7 
001B0004 
22560000 
00000004 
C2C70710 
00040808 
00040CA9 
000422EE 
07103000 
0910C2C7 
0OOBO7O4 
22OC000O 
00000004 
C2C 70710 
07040808 
00040CA9 
0004201 A 
00000000 



001B0704 
22560004 
00000004 
C2C7071D 
00040910 
OOOOOOOB 
00042202 
07103000 
0910C2C7 
000B0T04 
22E80000 
30000004 
C2C7071D 
07040808 
00040CA9 
00042256 
071D0000 
0910C2C7 
000B07O4 
22DC0000 
00000004 
C2C7071D 
00040910 
OOOOOOIB 
00042256 
07100000 
08D8C2C7 
OCA90004 
22020004 
30000004 
C2C7071D 
07040910 
OOOOOOOB 
0004220C 
071D0O0O 
0910C2C7 
001B0704 
22560004 
00000004 
C2C70710 
00040910 
OOOOOOOB 
^10042202 
07IO3000 
0910C2C7 
0O0BO704 
22E80000 
30000004 
C2C7071D 
070408D8 
00040CA9 
OOOOOOOO 



12/06/73 

08D8C2C7 
0CA90704 
22560004 
00000004 
C2C7071D 
00040910 
OOOOOOOB 



071D1000 
08D8C2C7 
OCA90704 
22560004 
00000004 
C2C7071D 
00040910 
OOOOOOOB 



fSVC ^act on a^ ^■aZ-^iX^ftd ■«*« ■Ca^-et}-^^ pace iz 



07103000 000422D2 



0004224C 00040CA9 00040808 C2C7071D 
071D1000 0004224C 00040CA9 00040808 
O808C2C7 07101000 0004224C 00040CA9 
OCA90704 08D8C2C7 0710300'^ ~~"'-'r^ 
220C0004 0CA90704 0910C2C ^«e h»aC 
00000004 2ZCA0OO0 00OBO7C/ _ >- 
C2C7071D 00000004 220000^ ^^*^ 
00040910 C^C7071D Q00Qaro 4 22C40b0d 



.OBG..... 
...86. 



Wt' 



SVC oA//^W 



II 

C2C70/10 

07040808 

00040CA9 

0004201A 

071D3000 

0910C2C7 

0O0BO7O4 

22C 40000 

00000004 

C2C7071D 

00040910 

OOOOOOIB 

00042256 

07100000 

0808C2C7 

0CA9000' 

22EE0000" 

30000004 

C2C 70710 

07040910 

00000008 

000422E8 

071D3000 

08D8C2C7 

0CA90704 

22560004 

00000004 

C2C 70710 

00040910 

OOOOOOOB 

000422EE 

071D3000 

0910C2C7 

001B0704 

224C0000 

10000004 

C2C70710 

07040820 

OOOOOOOO 






1UUUUUU4 

C2C7071D 
07040808 
0004 OCA 9 
000422EE 
071D3000 
0910C2C7 
000B0704 
220C0000 
00000004 
C2C70710 
07040808 
00040CA9 
00042256 



22D20000 
30000004 
C2C7071D 
07040910 
OOOOOOIB 
0004224C 
07100000 
08D8C2C7 
0CA90704 
22560004 
00000004 
C2C 70710 
00040910 
OOOOOOOB 
00042202 
07103000 
0910C2C7 
001B0004 
224C0004 
00000004 
CZC70710 
OOOOOOOO 



OOOlB 00040910 
42256 OOOOOOIB 
SySLOq Xe 00000 00042256 
^^4i,uout UVH-JUUU-. U0118C2C7 071D0OOO 
00000004 224C0004 OCA90004 08D8C2C7 
C2C7071D 00000004 20100004 OCA90004 
07040820 C2C7071D 30000004 22020004 
OOOOOOOB 00040910 C2C70710 00000004 
00042202 OOOOOOOB 00040910 C2C70710 
07103000 000422EE OOOOOOOB 00040910 
0910C2C7 07103000 000422D2 OOOOOOOB 
000B0704 0910C2C7 071D3000 000422EE 
22E80000 001B0704 0910C2C7 07103000 
30000004 224C0000 001B0004 08D8C2C7 
C2C70710 10000004 224C0004 0CA90004 
07040808 C2C7071D 10000004 224C0004 
0004 QCA9 070406D8 C<U:7071D 10000 004 
1)40808 C2CTI )71D 
07 1 

OOOBOOO' C* 
22EE000( 

30000004 22D2000D OOOB0004 09i;0C2C7 
C2C7071D 30000004 22EEOOO0 001B0004 
07040910 C2C7071D 30000004 22EE000O 
OOOOOOIB 000408D8 C2C7071D 00000004 
0004224C 00040CA9 00040808 C2C7071D 
071D1000 0004224C 00040CA9 00040808 
0808C2C7 OncilOOO 0004224C 00040CA9 
0CA90704 08O8C2C7 07103000 00042202 
22DC0004 0CA90704 0910C2C7 071D3000 
00000004 22C40000 0O0BO704 0910C2C7 
-C2C7071O 00000004- 220C0000 00080704 
00040910 C2C70710 00000004 22C40000 
00000008 00040910 C2C70710 00000004 
000422EE OOOOOOIB 00040910 C2C70710 
071D3000 000422EE OOOOOOIB 00040910 
0808C2C7 07100000 00042256 OOOOOOIB 
OCA90004 08D8C2C7 07100000 00042256 
20100004 0CA90004 0820C2C7 07100000 
00000004 224C0004 0CA900D4 0808C2C7 
OOOOOOOO 



^. ..'-'* 



.OBG 

.OBG. 



..OBG. 

....QBG... 



..BG.... 
...BG. 



.QBG.... 

..QBG 



5t/C 7. 



'• Sysco c Tp.fsp 

"...., loBtf^f^ 

....QBG ^ ^^ 

BG Vr^ /}^ 



(t>i»H 



An example showing a GSVC trace in core-wrap output in an alternate area. The 
alternate area is dumped on termination of PDAID and is given back to the main 
page pool. (The beginning of the alternate area is not shown). 



2.54 Serviceability Aids 



QTAM Trace 

This trace records the sequence of SIO instructions issued to channels and devices. 
The data recorded is similar to that of the I/O trace, but gives more details about 
the type of I/O interrupt. 

This routine is designed to trace programs running in real mode. However, it can be 
used to trace virtual mode programs provided the following is considered when 
reading the trace output: 

• If the program being traced is running in real mode the CCB address and the 
CCW address in the CSW are real addresses. 

• If the program being traced is running in virtual mode, the CCB address and 
the CCW address in the CSW are, respectively, the address of the CCB copy 
block. (Refer to Section 4 Chapter 13 for a description of CCB and CCW 
copy blocks.) 

There are three types of trace events and each type is recorded, having a prefix 
that defines the type. 

The data is recorded in the PD area, either in a trace table or, when using the 
core-wrap mode of output, in a rotating buffer. The format of the data recorded 
is as follows: 

• On the occurrence of an SVC interrupt; 



SVC 

No. 



1 — I — I — \ — I — I — r 

SVC OLD PSW 

J I ! I II I 



1 1 — 

GRO 



GR1 
I I I 



ISYSLDGl 
ID 



Trace Routines 

PDA IDS 



Prefix V 
X'E5' 




AR 

BG|-(See note 5.) 

Fn 



- General purpose register 1 
General purpose register 



(See note 4) 



Value of the Supervisor Call (See note 2.) 



• On the occurrence of an SIO instruction 



— 1 1 r- 

CCB ADDR 
I I I 



1 — I — \ — I — r 

CSW 

J I \ I L 



j 1 i 1 

FF FF FF FF FF 
1(11 



Device 
Addr 



Prefix S 
X'E2' 



Condition code 



Not used 



• On the occurrence of an I/O interrupt; 



Device 
Addr 



1 — I — I — I — i i — r 

I/O OLD PSW 
J I I I \ L L 



"1 — I — r 

CSW 



J L 



FF FF 
I 



t 
Prefix I 

X'C9' 

Notes: 

1. The PSW and CSW are described in E-2 of this Section. 

2. A list ofDOS/VS SVCs can be found in Section 4. 

3. The CCB is described in Section 4. 

4. General purpose register usage is described in Section 4. 

5. The SYSLOG ID is described in Appendix B. Fn can be Fl up to the 
highest numbered foreground partition available in the system. 

Any of these occurrences is referred to as an event. 
For each event, an entry is generated. 



Not used 



Serviceability Aids 2.55 



Trace Routines 

PDA IDS 



By the selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utility program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 

Tracing Options: The QTAM trace function provides the following options: 

• Trace all SVC and 3 1 , SIO , and I/O interrupts. 

• Trace SVC and 31 , SIO, and I/O interrupts from any three devices. 

• Ignore SVC and 31 , SIO, and I/O interrupts from any three devices. 

• Trace in all partitions 

• Selectively trace one or more partitions. 

Trace hmiting options are specified by the initializer message parameters 
IGNORE DEVICE= or TRACE DEVICE=. (The device options are invoked by 
specifying the three devices to be traced or ignored.) All SVC and 31 , SIO, 
and I/O interrupt activity is traced in all partitions of core if one of these 
options is not specified. They are nmtually exclusive: when one is specified, the 
other becomes invalid. 

The partition limiting options are specified by the initializer keyword TRACE 
PARTITION=. 

When to use: Use the QTAM trace to check the sequence of SIO instructions 
to the channels and devices. Use this trace if you suspect errors in I/O interrupt 
handling routines or in program routines issuing SVC and SVC 31 , or if you 
suspect errors in the sequence of I/O interrupts being returned from channels 
or devices. The next two illustrations are examples of output from a QTAM 
trace. 

The next example shows a dump of the real address area containing trace output 
when the core-wrap output mode in an alternate area is selected. 






'^v j/ 



y 



2.56 Serviceability Aids 



o 



Trace Routines 

PDAIDS 



TERMKEN 



12/06/73 



GR 0-7 80040B0C 00041500 0003F800 00000000 

GR 8-F B00400A4 900*1086 00000000 182F07FI 

FP REG 00000000 00000000 00000000 00000000 

CR 0-7 004000FF 0000E640 FFFFFFFF FFFFFFFF 

CR 8-F OOOOFFFF 00000000 00000000 00000000 



3t' 



o 



00000050 00041084 00042084 00040FB8 
00040078 40040084 0003FFF5 08041518 
00000000 00000000 00000000 00000000 
00000000 00000000 00000000 00000000 
00000000 00000000 C2000000 00000200 



03F800 
03F820 
03F840 
03F860 
03F880 
03F8*0 
O3F8C0 
03F8E0 
03F900 
03F92Q 
03F940 
03F960 
03F980 
03F9*0 
03F9C0 
03F9E0 
03y 

=A20 
03FA40 
03FA60 
03FA80 
03FAA0 
03FAC0 
03FAEO 
03FB00 
03FB20 
03FB40 
03FB60 
03FB80 
03FBA0 
03FBC0 
03FBE0 
03FC00 
03FC20 
03FC40 
03FC60 
03FC80 
03FCA0 
03FCCO 
03FCE0 
03F000 
03FDZ0 
03FD40 
03F060 
03FD80 
03FDA0 
03FDC0 
03F0E0 



FT) OC 0000 
0130070F 
04000000 
09070F20 
OOOOOOFF 
O70F2OOO 
OOOOFFFF 
OF 200000 
OOFFFFFF 
20000000 
FFFFFFFF 
00000009 
FFFFFFFF 
AOIO00E7 
00FFFFC9 



0F200000 

20OO00OO 
FFFFFFFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
O009OC00 
FFFFC900 
090C0000 
FFC90009 
OCOOOOOO 
C 9000907 
60084000 
0130070F 
04000000 



090COOOO 
FFC90130 
OCOOOOOO 
C9000907 
00000000 
0009070F 
00000004 
09070F20 
00000400 
070F2000 
00040000 
OF200000 
50FFFFFF 
20000000 
FFFFFFFF 



003AF00C 
30070C20 
00000400 
070F2000 
00040000 
OF200000 
04000000 
20000000 
OOOOOOFF 
00000009 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C10 
FFFFC901 
O9OC0O00 
FFC90130 



OOOOOOFF 



00000009 
OOOOFFFF 
00O009OC 
00FFFFE2 
00090C10 
FFFFE200 
090C1000 
FFE20000 
0C100076 
E2000009 
100076C8 
00000900 
OOE76008 
30070C20 
00000400 
070F2000 



090crooo 

FFEZOOOl 
OC000087 
C9Q13007 
00000000 
0009070F 
003AF00C 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
000039AO 
08000000 
0039A000 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
000087A0 
FFFFC901 
00000004 
FFE20001 
OC000087 
E20002A2 
00O0E838 
O13007OF 
OCOOOOOO 
01300000 
3AF00COO 



01300000 

Ut 06666 

30000039 
AOOCOOOO 
OC200000 
04000000 
20000000 
OOOOOOFF 
00000009 
FFFFfFFF 
0000090C 
FFFFFFC9 
OOO087AO 
FFFFC901 
00000004 
FFE20001 
OC00003A 
C9013007 
00000000 
0130070F 
OCOOOOOO 
30070F20 
OOOOOOFF 
30000039 
AOOCOOOO 
0000E6C8 
OC000012 
20000000 
FFFFFFFF 
39AOOOO0 
OOOOFFFF 



39AQ0000 

OOOOFFFF 

AOOOOOOO 

00FFFFE2 

00090COO 

FFFFE200 

090COOOO 

FFE20001 

0C00003A 

C9013007 

00000000 

0130070F 

OCOOOOOO 

30070F20 

OOOOOOFF 

30000039 

FOOCOOOO 

0C200000 

04000000 

20000000 

FFFFFFFF 

00000009 

FFFFFFFF 

AOOOOi 

OOFFFI 

OdOOBt; 

FFFFE200 

090C0000 

FFC90130 

87A0OCOOI 

E2000130 



3AF00C00 OOOOFFFF 



C9013007 

00040000 

0001300J)v 

003AC008 

OlSOOOpfl! 

00000400 

3000003f? 

FOOCOOOO 

OC200000 

04000000 

20000000 

FFFFFFFF 

00000009 

FFFFFFFF 

A000003A 

00FFFFE2 

00090COO 

FFFFE200 

090COOOO 

FFC 90130 

OCOOOOOO 

C9013007 



OF 200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
{3(9AOOOOO 
OOOOFFFF 
sAe<K)003A 
'00FFFFE2 
00090COO 
FFFFE200 
090COOOO 
FFC90130 
OCOOOOOO 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87AO0COO 
070C2000 
00040000 
OF200000 



7f^ 20001 
OC00003A 
E2000130 
00iOO87AO 
00000900 
0078D008 
00090000 
79380800 
09000076 
60080000 
000076C8 
08400000 
00E6C800 
400050FF 
00000009 
OOOOFFFF 
0000090 C 
FFFFFFt 9 



OOFFFFFF 



00090COO 
FFFFC901 
0087 AOOC 
FFC90130 
00000400 
C9013007 
FOOCOOOO 
00013000 
003AC008 
01300000 
87A00C00 
070C2000 
00040000 
OF200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
39A00000 
OOOOFFFF 
0000090C 
00FFFFE2 
00090C00 
C901 



30000039 
C0080000 
000039AO 
OCOOOOOO 
00780000 
OOOOOOFF 
79380000 
OOOOFFFF 
60000000 
00FFFFC9 
00000000 
FFFFC900 
00000004 
FFE20001 
OC00003A 
E2000130 
00003AFO 
0130070C 
00000004 
30070F20 
OOOOOOFF 
070F2OOO 
OOOOFFFF 
0F200000 
OOFFFFFF 
0039A000 
OOOOOOFF 
39A00OOO 
OOOOFFFF 
0000090C 
00FFFFE2 
00090COO 
FFFFC901 
003AF00C 
FFC90130 
00000400 
E2000130 
00003ACO 
00013000 
003AFOOC 
30070F20 



A000003A 
0OFFFFC9 
00000000 
FFFFC900 
00000004 
FFC90009 
00000400 
C9000907 
00040000 
0009070F 
04000000 
09070F20 
OOOOOOFF 
30000039 
C0080000 
000039AO 
OCOOOOOO 
20000000 
OOOOOOFF 
00000009 
FFFFFFFF 
0000090C 
FFFFFFC9 
00090COO 
FFFFC901 
003AFO0C 
FFC90130 
00000400 
E2000130 
00003ACO 
00013000 
003AF00C 
30070F20 
OOOOOOFF 
070F2000 
OOOOFFFF 
000039A0 
08000000 
0039 AOOO 
OOOOOOFF 

oooog 



00000000 



013( 
3AF( 
070f 
OOOC 
000( 



■svco 



f^/ 9^f 



SVC <^/>SW 






7 ^z^. 






TERMKEN 




12/06/73 












03FEOO 


070F2000 


0000090C 


000087AO 


OCOOOOOO 


FFFFE200 


01300000 


39A00OO0 


87A00C00 


03FE20 


OOOOFFFF 


FFFFFFC9 


0130070F 


20000000 


090COOOO 


3AF0OC0O 


OOOOFFFF 


E2000130 


03FE40 


000039AO 


00003AFO 


OCOOOOOO 


FFFFFFFF 


FFC90130 


070F2000 


0000090C 


000087AO 


03FE60 


OCOOOOOO 


FFFFE500 


00071000 


00000415 


42A00410 


6C000414 


88C2C7E2 


0002A200 


03FE80 


00E6C800 


0087AO0C 


OOOOOOFF 


FFFFFFFF 


C902A207 


0F20OOO0 


00090C10 


00E83B0C 


03FEA0 


OOOOOIFF 


FFE5O000 


071D0O0O 


00041542 


A004106C 


00041488 


C2C7E200 


02A20000 


03F6C0 


E6C81000 


E8380C00 


OOOIFFFF 


FFFFFFC9 


02A2070F 


20000000 


090C1000 


E7600COO 


03FEE0 


OOOIFFFF 


E5000007 


10000000 


041542A0 


04106C00 


041488C2 


C7E20002 


A20000E6 


03FFOO 


C81000E7 


600COOOO 


OlFFFFFF 


FFFFC902 


A2070F20 


00000009 


OC1000E8 


3B0C00OO 


03FF20 


01FFFFE2 


00013000 


0039A010 


O0E838OC 


OOOOOIFF 


FFFFFFFF 


C90X3007 


OF 200000 


03FF40 


00090COO 


003AFOOC 


OOOOOOFF 


FFE20001 


30000039 


A000003A 


FOOCOOOO 


OOFFFFFF 


03FF60 


FFFFC901 


30070F20 


00000009 


OC00003A 


FOOCOOOO 


00FFFFE2 


00013000 


0039A000 


03FF80 


0O3AF00C 


OOOOOOFF 


FFFFFFFF 


C9013007 


OF200000 


00090C00 


003AF00C 


OOOOOOFF 


OJ^FAO 


FFEZOOOl 


30000039 


A0OOO03A 


FOOCOOOO 


OOFFFFFF 


FFFFC901 


30070F20 


00000009 


03FFC0 


0C0OOO3A 


FOOCOOOO 


00FFFFE2 


00013000 


0039A000 


003AF00C 


OOOOOOFF 


FFFFFFFF 


03FFE0 


00000000 


00000000 


00000000 


00000000 


00000000 


00000000 







.HH I v.. 

V BGS 

MH..V I X-.. 

....V BGS U 

H..X-... I v.... 

...S V I.. 

S 

..1 S 

..0... I .0..... 

.^S O.., ......I...*.,,,. 
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An example showing a dump of the alternate area used for a QTAM trace in core- 
wrap output mode. 



Serviceability Aids 2.57 



Trace Routines 

PDA IDS 






01S900 
016920 
016940 
01S960 
016980 
0169A0 
0169:0 
01S9EO 
016A00 
016420 
016A40 
016460 
016480 
OIS440 
0164CO 
016AE0 
01 6800 
016B20 
016840 
016860 
016880 
016840 
OlSBCO 
0169EO 
016C00 
016FE0 

-P.O.- 
009480 
009440 
0094C0 
0094?0 
0095 00 
009520 
009 540 
009560 
009580 
009 54 
0095C0 
0095?0 
009600 
009620 
039540 
019660 
009680 
009 64 
0096C0 
0096E0 
009 700 
009720 
009 740 
0099F0 

IBLTYP 
— ^G-- 
04D000 
040020 
04D040 
040060 
04D080 
0400AQ 



OOOOOOOE 
831 0:2:7 
EEEE0i:8 
OOOOD008 
00000300 
00020DOO 

83io:2:7 

EEEE0i:8 
000000 08 
00000300 
00020007 
0000003= 
OOOOOOOE 
EEEE0165 
EEEE0134 
87878787 
00000007 
000002:8 
EEEE0196 
EFEE0134 
87873787 
00000007 
000002:0 
80008420 
00003330 
00000000 

AREA 

00003300 
FFFFFFCF 
FFFFF^JO' 
078A*i00 
90BC42;o 
91010734 
58700014 
402091)2 
92FF8010 
91023334 
91765880 
00805330 
91C44138 
00006 3.60 
0004?334 
90B79D4; 
47F 09246 
49S093JS 
95FF903C 
4:709232 
4150913 4 
00000330 
00000303 



O00OF728 08000000 0000F718 
80006690 71006700 200E2880 
470DOOOO 00008486 00081010 
000164CO 000087DA 00000030 
80008860 A0008944 000087CO 
00000007 00008B50 00000017 
80006690 71006700 200E28BO 
47000000 00008AB5 00081010 
000164EO 000087DA 00000030 
80008860 A0008944 000087C3 
00000007 00008B6O 00000017 
00000000 04000000 0D00F713 
00000000 04000000 O0O0F7A8 
070C2000 00000962 00001013 
040C2000 OO0009BC 00001013 
80808080 80838080 80808083 
00008B60 00000017 03008848 
00040000 00003AB4 000004AO 
47000000 00008AB5 00081010 
040C2000 000009BC 00001013 
80808080 80838080 80808083 
00008B60 00000016 00008848 
00040000 O0303AB4 000004A0 
000004AO 000087CO 000087CO 
— SAME— ^,-r r, /- / 
00000000 ^J /5^ Y 

E30099FF 0000479C 
00004798 00003ABt , 00031333 
OOOSFeOd |0003FFF5k 3FDEFFFF 



EEEE01B4 
87878787 
00000007 
000002DO 
EEEE0196 
EEEE31B4 
87878787 
00000007 
003002:8 
EEEE0196 
EEEE0166 
EEEE31DC 
FF0OF640 
OOOOOOOE 
8310C2C7 
EEEE01C8 
00003038 
00003300 
30O;',300O 
831o:2C7 
EEEE31C8 
00000008 
00003300 
00000000 



040C2000 
80808080 
00008B60 
00040000 
470DOOOO 
040C2000 
80808080 
00008860 
00040000 
47000000 
070F2000 
O40C0000 
OOOOOOOE 
OO0OF7B8 
80006690 
47000000 
000164E0 
83008863 
00000007 
80006590 
47000000 
00016500 
80008860 
00000000 



000009BC 
80838080 
00000018 
00003AB4 
00008AB6 
00300980 
80833080 
00000017 
a0303AB4 
000084C0 
00000962 
000016 8E 
00003FFO 
08000000 
71006700 
00003AB6 
000037DA 
A0008944 
00008860 
71006^00 
00008486 

oobbteoA 
90o;oa944 
00006000 



00001010 
80838080 
0000 8848 
000004AO 
00081010 
00001010 
80808080 
00008848 
OO00O4A0 
00081010 
00001010 
00031010 
080060C6 
0000 F7A8 
200E2880 
00081010 

opooooso 

CK)0087CO 
,Q000 0016 

?"00E2880 

0.0081010 
,^003 0030 
.0000 8 7C0 

0000 0000 



00 00000000 00000000 00000000 



StaH' 0/ S&n/ma 



/>^^4i/<tC 



91C492C9 
B01C9200 
00155980 
00009488 
00041020 
91809058 
0203913C 
47809155 
47809298 
43709232 
58690000 
— SAME — 
00000000 



80003201 
91579878 
91CB4740 
0003F800 
909F9048 
471O920A 
922647F0 
4930903A 
5850903C 
IA755050 
47F0926E 



800100BA 
91B8D602 
91AA5883 
0003FFCB 
D20393A5 
D2119144 
924648B3 
077A9533 
58609043 
91C05053 
58B091C3 



O000153E OO00B44E 00000C55 
J2Z:*C1C9 C4D3E3ES FFFF3309 

5 00 

IDl 

320 

IC4 

207 

)78 

u (Bft'»700 

801392FF 

B00691CF 

91B807FA 

E710300E 

32009381 

921C3201 

00000015 

90989296 

18761866 

913447F0 

B00047F0 



D20F8003 
B00391CC 
91C05380 
0003FFEO 
9049D233 
923495FF 
91D29156 
939Fi?73 
D2039054 
91C45373 
92FFB030 



00 3892FF 
078AD501 
91C49878 
C4E4D405 
90489044 
903A4770 
906COOO0 
92540201 
9O401B65 
91C89857 
0213B001 



00009F02 
FFFFFFF= 
0003FFF5 
4403 9186 
B0454770 
078495FF 
9001 8008 
41UOOO0 
8008 0040 
91880201 
91564700 
801458B0 
07845880 
00000000 
00000C56 
9043D200 
913E9224 
47809156 
9057913<t 
5D609230 
9244AO00 

906: 0000 



00000000 00000300 00300000 00300000 00000000 00000000 



HEX LE-^GTH IS 0000 

37:8:i;2 :55C5C5C 07102000 000403:E 

07C8:i;2 B004009E 00040620 OOOOOOOO 

7FOB39*E 80000015 00088FFF 900421F6 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

58103536 58F10010 45EF300C D24FB13E 

B58A5330 B58E0A12 5810BS92 SC00B596 



00003030 OOOOOOOO 40343074 00040078 

00D2F000 00088FFF OOOOOOOO OOOOOOOO 

30308450 5706A7E4 00003000 00030000 

00003000 00300000 05a0024F B18E84AE 

B4FE5313 B58658F1 D01345EF 000;5813 

0A3A1B99 12334780 80460630 47F0B03A 



,7. ..6 0..-F 



BG 



/^AcMJt, //a>me, ^ PD/I/D gr/f/^ i^ 



■/C^i^-K-^ " 






J J. 

K K 

.0 0. 



....K ...3. 

.K...a 

0.1..< K.... 



.0 H IV..D.... 

...- 8 OUMNX. 



#...-. K -. 

##..#/!> .0l»..H...M.0... 

. «.M K 0... 



PHASE*** 

PHAS KO 

...4- 6 ...l*....U. . 



.0.. (If/I) 






The example above shows part of a system dump output. By examination of the 
PDAREA printed in the dump (when PDAID is supported by the system) it can 
be seen that a QTAM trace was active when the dump was executed. From the 
PDAID phase name in the PD area, the output mode for the trace was core-wrap. 
However, no trace entries are seen in the PD area, which indicates that the 
alternate area had been specified for the trace entries. The start address of the 
alternate area is contained at displacement decimal 20 from the start of the PD 
standard preface table. (The standard preface table starts at the PDAID 
phase name.) 



2.58 Serviceability Aids 



Trace Routines 

PDAIDS 



lOfOS/Ti 



^^•iWl''^ 



O14BC0 
OlSBEO 
016COO 
OlSFEO 

-P.D.- 
009480 
OD^'.AO 
OOgitCO 
009*EO 
009500 
009520 
009540 
009560 
009580 
0095AO 
0095C0 
009 5E0 
009500 
009620 
009640 
009650 
009680 
0095AO 
0095C0 
0Q96E0 
009700 
009720 
009740 
009750 
009780 
C097&0 
009 7C0 
0097E0 
009 800 
009 82 
009840 
009 860 
009 880 
009 8*0 
0098CO 
C09 8E0 
009900 
009920 
009940 
009950 
009980 
0099*0 
C099C0 
0099EO 



000005*8 OOOBIOOO 00003AE4 00004360 
000B237& 07C8C1E2 80081360 O0OB32A8 
00000000 — SAME— 
000000 00 00000000 00000000 00000000 



AREA 

00003390 
FFFFFFFF 
FFFFi=F90 
078A4400 
90BC42;0 
91D1078(. 
5870001' 
40209132 
92FF8310 
91D2033* 
91765880 
008053B0 
91C44188 
00005350 
OF20333Q 
OOFFFFFF 
20000030 
008B6):5 
F8C80000 
OOOOFFFF 
00003952 

ffffff:9 

008AS600 
FFFFE233 
09620030 
F2C9000: 
00000400 
E 5003047 
00000000 
000E073C 
00000700 
OO0EO030 
F9200800 
070F2000 
00040300 
OC200300 
00008350 
00F8CS00 
OOOOOOFF 
00000339 
FFFFFFFF 
00008AB6 
00FFFF88 



00004793 
FFFFFFFF 
FFFFFFFF 
918E078A 
9101 95 FF 
907891B8 
4870 705A 
92E28000 
02038011 
47F09156 
91C492C9 
B01C9200 
00155980 
00009488 
00096200 
FFFFC900 
0962000Q 
F2C9000E 
00000400 
E5000047 
00000000 
000EO70C 
00000700 
OOOEOOOO 
F7B80800 
070F2000 
OOOOFFFF 
00000000 
04000000 
20000000 
008B60C5 
F8C80000 
OOOOFFFF 
00000962 
00FFFFE2 
00095200 
C5F2C903 
00000004 
FFE50000 
62000000 
C9000E07 
00000007 
C5F25BD1 



000099FF 
00003AE4 
FFFFFFFF 
47F090EC 
9500008B 
9101078A 
588091C4 
1A7C0201 
50180004 
80109430 
49B09035 
8000D201 
91579878 
91C84740 
0000965C 
00000004 
OE070C20 
F9200800 
070F2000 
OOOOFFFF 
00000000 
04000000 
20000000 
008B60C6 
F8C80000 
OOOOFFFF 
00000962 
FFFFFFC9 
008AB600 
FFFFE200 
09620000 
F2C9000E 
00000400 
E5000047 
00000000 
OOOOOEOO 
00F92008 
0E070F20 
OOOOOOFF 
47000000 
00040000 
OC 2 00000 
00008860 
D5C2C3E3 



0000479C 

00001003 

3FDEFFFF 

47F09132 

4780908E 

95FF9lbJ 

92E58OO0 ' 

80137002 ■ 

402800C(2 

800192F*6 

078A49B'0 

800100BA 

91B8D502 

91AA5880 

0000993B 

OOOOOOFF 

00000009 

OOOOFFFF 

00000952 

FFFFFFC9 

008AB500 

FFFFE200 

09620003 

F2C9000E 

00000430 

£5000047 

OOOOOOOO 

000EO70C 

00000700 

OOOEOOOO 

F7B80800 

070F2000 

OOOOFFFF 

OOOOOOOO 

04000000 

O0F8C8OO 

OOOOOOFF 

00000009 

FFFFFFFF 

OOO0BAB5 

00FFFFE2 

00096200 

C6F2C900 

D3C7040B 



OOOOOOOO 80008860 90008944 000087CO 
OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 






OO00168E 
07:4C1C9 
FFFFFFFF 
47009104 
951F008B 
078A95FF 
02018001 
'47F0919A 
187*8870 
915747F0 
'9638078A 
(J20F8003 
B00391CC 
91C0508O 
000099E3 
FFE20D00 
520000F7 
C9000E07 
OOOOOOOO 
O0OE070C 
00000700 
OOOEOOOO 
F9200800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
008B60C6 
F8C80000 
OOOOFFFF 
00000 952 
FFFFFFC9 
008AB600 
FFFFE200 
00000004 
FFE50000 
52000000 
C9000E07 
00000007 
OOOOOEOO 
00F92008 
OE070F20 
1958000B 



000OB44E 
0408 E3E& 
FFFFFFFF 
58B0O0S0 
077A58B0 
91D1078A 
008A0207 
907891B8 
00184278 
913C9200 
49B0903A 
003892FF 
078A0501 
91C49878 
C4E4D405 
OEQOOOFS 
B808O0O0 
0F200000 
04000000 
20000000 
008B60C6 
F8C80000 
OOOOFFFF 
00000962 

ffffff;? 

008AB600 
FFFFE200 
09620000 
F2C9000E 
00000400 
E5000047 
OOOOOOOO 
000E070C 
00000700 
OOOEOOOO 
OOOOOOFF 
47000000 
00040000 
0C200000 
00008B63 
00F8C800 
OOOOOOFF 
00000009 
2888000B 



00000C56 
FFFF3009 
FFFFFFFF 
58B0B01C 
00809500 
95FF91D1 
80030020 
588091C4 
00010207 
91579078 
078A4700 
801392FF 
B0O591CF 
918837FA 
E740000E 
:8003000 
00FFFFE5 
30096200 
FFFFE200 
09520000 
F2C9000E 
00000400 
H5003047 
OOOOOOOO 
O0OE37OC 
00000700 
000E3000 
F9200800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
008B50C6 
F8C 83000 
FFFFFFFF 
00008AB6 
00FFFFE2 
00095200 
C5F2:900 
00000004 
FFE50000 
62000000 
2888C6F2 



00009F02 
FFFFFFFF 
FFFFFFFF 
44009186 
B0454770 
078*95FF 
9001 BOOB 
41110000 
8008 0040 
91B80201 
91564700 
8014 5 880 
078*5880 
OOOOOOOO 
C900OEO7 
00040000 
00004700 
00030004 
OOOEOOOO 
F7B80800 
070F2000 
OOOOFFFF 
OOOOOOOO 
04000000 
20000000 
0088 60C5 
Fee 8 0000 
OOOOFFFF 
00000962 
FFFFFFC9 
008*8500 
FFFFE200 
0962 0000 
F2C9000E 
00000400 
C900 0E07 
00300007 
OOOOOEOO 
00F7B808 
0E070F20 
OOOOOOFF 
470D0000 
00040003 
OOOOOOOO 






.J. ..J.... .J J J. 

.......O.V.. K K...... 

IC 0. 



.K...0 

D.I..IC..... K.. 

N N 

.0 H *..0 

...- * TDUMNX ..I... 

S 8H 

1 7 v.... 

...>«... .9. ...... I 

..<F?> S 

8H.>:%.........I WL...7... 

••••V -^^ 

riiini'ii^^i.r 9;;:..i^vrrrrr;r 
••: "^ : 




.8H. 



\W. 



S 8H I.. 

' V... 

S... 

V ...-@.... 

S .....8H.>; 

....I 9 V 

-F2I 

....F2£J0BCTLG F2... 



LBLTYP HEX LENGTH IS 0000 
-F2 — 
81000 (D7C8C1E2 C55C5C5C O74D0000 000B146E 



00000001 00000013 400B107& 000B207* 



/■u^e^^ FZ A/}^/-^^^^^^ yla-v^^ czyiS^ 






This example shows part of a system dump output that by examination of the PD 
area indicates QTAM trace entries in the PD area. Compare this example with the 
previous one and note the difference between the information contained in the 
PD area. 
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PDAIDS 



VTAM Trace 

This trace records the sequence of SIO instructions issued to channels and devices. 
The data recorded is similar to that of the I/O trace. 






There are three types of trace events and each type is recorded, having a prefix 

that defines the type. 

The data is recorded in the PD area, either in a trace table or, when using the 

core-wrap mode of output, in a rotating buffer. The format of the data recorded 

is as follows: 

(See note 6) 

• On the occurence of an SVC interrupt; i 

I ' V 

1 , 1 , , , ^ — 



V 



SVC 
No. 



SVCOLDPSW 

J I 1 I J . , , ' , 



— , p 

GRO 

\ 1- 



GR1 

Jl I L. 



SYSLOG 
iC_ 



Prefix V 
X'E5' 



AR 
BG 
Fn 



- (See note 5) 



^ General purpose register 1 
General purpose register 



~*^ Value of the Supervisor Call (See note 2) 
• On the occurrence of an SIO instruction 



Device 
Addr 



— I ,. , — 

CCB ADDR 

I I I 



-I — I — r 



CSW 



— I — I — I — I — 

FF FF FF FF FF 

r I J 1 , 



Condition code 



Prefix S 
X'F3' 



Not used 



-(See note 4) 






• On the occurrence of an I/O interrupt; 



Device 
Addr 



I/O OLD PSW 



CSW 

J I 1- 



T 

Prefix I 
'XC9' 

Notey. 

1. The PSW and CSW are described in E-2 of this section. 

2. A list of DOS I VS SVCs can be found in Section 4. 

3. The CCB is described in Section 4. 

4. General purpose register usage is described in Section 4. 

5. The SYSLOG ID is described in Appendix B. Fn can be Fl 
up to the highest numbered foreground partition available 
in the system. 

6. For SVC 53 only, this word of the record contains the 
^ function code and a pointer to the parameter list 

' passed with the supervisor call. 

Any of these occurrences is referred to as an event. For each 
event, an entry is generated. 



FF FF 



Not used 



> 



2.60 Serviceabihty Aids 



By the selection of the trace output device, the event can be: 

• Recorded on magnetic tape 

• Preserved in the PD area 

• Preserved in an alternate area. 

When magnetic tape output is used, the tape must be processed by the PDLIST 
utiUty program to provide a formatted output on a line printer. 

The modes of output and PDLIST are described under B-1 in this Section. 

Tracing Options: The VTAM trace function provides the following options: 

• Trace all SVC 49 and SVC 53 interrupts - this may be limited by 
selectively tracing partitions. 

• Trace all SIO instructions and I/O interrupts - this may be limited by 
selectively ignoring up to three devices, or by selectively tracing up 
to three devices. 



Trace Routines 

PDAIDS 







Trace-limiting options are specified by the initializer messages or parameters - 
IGNORE DEVICE = or TRACE DEVICE 

Trace-limiting options are specified by the initiaHzer messages or parameters - 
IGNORE DEVICE= or TRACE DEVICE=, and TRACE PARTITION^. (The 
device options are invoked by specifying up to three devices to be traced or 
ignored. TRACE DEVICE and IGNORE DEVICE are mutually exclusive; 
when either is specified, the other becomes invalid. The TRACE PARTITION= 
option is invoked by specifying the partitions to be traced and only affects the 
recording of SVC 49 and SVC 53.) 

When to use: Use the VTAM trace to check the sequence of SIO instructions 
to the channels and devices. Use this trace if you suspect errors in I/O interrupt 
handling routines or in program routines issuing SVC 49 and SVC 53, or if you 
suspect errors in the sequence of I/O interrupts being returned from channels or 
devices. However, the traces can cause degradation in VTAM performance, so 
indiscriminate use should be avoided. 

Tlie example shows a dump of the real address contains trace output when the 
core-wrap output mode in an alternate area is selected. 
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VTAM Pool Use Trace 

This trace monitors the use of VTAM buffer pools. When active, the location 
ISTPDAVP in the supervisor table ISTAVT contains the entry point address of 
PDAIDVPT. The module is entered from ISTGRCRQ on every 1000 requests 
for VTAM fixed-length buffers. 

Without networking (VTAM Level 2): 

On each entry a 92-byte buffer is written to tape. The record contains: 

1 byte - the EBCDIC character P 



3 bytes 
8 bytes 
80 bytes 



a sequential count of records 

a clock value from STCK (zero if not set) 

ten entries in the format: 



POOLID 

INUSE 

MAXBF 

MAXQD 



2 bytes EBCDIC 
2 bytes binary 
2 bytes binary 
2 bytes binary 



values from 
pool control 
block 



c 





HHHHHHJ 


HH 




HH 


Hi 


■ 


HI 


H 


■ 




■ 












// JOB LIST TAPE 
// USSGN SIS005,X 
// £XEC PELIST 


3S1' 










DATE 


C6/C a/75, CLOCK 20/2 V2« 








1 






0CD3 1 VTAM EUFFEF 


POOL USE - 


DAI 119 TIME 


02:03:2"* 




















1 






sr INUSE = 


ceo?'' MAX 


ALL3C = OCOCO 


MAX Hnl't = 


D0D30 


LF 


INUSE = 


00000 


MAX 


ALLOC = nooco 


HAX 


HAir = 


porpp 


H 






SP INUSE = 


OC??'' MAX 


ALL3C = OC^O 


MAX »kiX = 


J0D3: 


LP 


INUSE = 


COOC 1 


1AX 


ALLOC = nnnm 


HAX 


WAT'T = 


niAfin 


H 






AP I NOSE = 


CrOCO MAX 


ALLOC = CCrC!! 


MAX i^Air = 


00000 


HP 


INUSE = 


CCOOO 


MAX 


ALLOC = nnnon 


HAX 


«AT1> = 


nPPr>P 


H 






PP INUSE = 


"C.Of' MAX 


ALLOC = rorcc 


MAX liAIf = 


00030 


NP 


INUSE = 


rooai 


HAX 


ALLOC = nooci 


HA» 


mrr = 


OPTPP 


H 






VF INUSE = 


?C0C2 MAX 


ALLOC = Cn02 


HAX WAIT = 


30030 


VP 


INUSE = 


CO^Sl 


HAX 


ALLOC = conup 


HAX 


WAIT = 


('crr^r 


H 






00032 VTAH BUFFER 


POni. USE - 


DAY 1ig TIME 


02:03:30 




















H 






SF INUSE = 


OCOOr MAX 


ALLOC = CCOCC 


MAX ilAXT = 


33330 


LF 


INUSE = 


CC300 


MAX 


ALLOC = t^nr\rr> 


HAX 


VAI" = 


'^nonp 


H 






SP INCSE = 


CC?OC MAX 


ALLOC = crrcc 


MAX «Air = 


00000 


LP 


INUSE = 


00001 


MAX 


ALLOC = rrinoi 


HAX 


WAIT = 


rrprp 


H 






AP INUSE = 


00700 MAX 


ALLOC = rc:cc 


MAX i*Air = 


00300 


HP 


INUSE = 


cooo 


MAX 


ALLOC = fipPOP 


HAX 


WAIT = 


ppprp 


H 






PP INUSE = 


ooc:r MAX 


ALLOC = on?o 


HAX «I»IT = 


OCOOi 


NP 


INUSE = 


3T0C1 


HAX 


ALLOC = oonon 


HAX 


HAIT = 


opppp 


H 






VF INUSE = 


0CCr2 MAX 


ALLOC = OOCOO 


HAX nlAIT = 


03333 


VP 


INUSE = 


0003C 


HAX 


ALLOC = Pinnn 


HAX 


HA IT = 


r\r^i\r\i\ 


H 






000*3 VTAM BUFFE!! 


POOL USE - 


DAY 119 TIME 


02:03:32 




















H 






SF INUSE = 


''OCOC MAX 


ALLOC = onco 


max" «Air = 


00000 


L? 


INUSE = 


C0007 


HAX 


ALLOC = PnP07 


HAX 


H«IT = 


riOPPn 


H 






SP INUSE = 


aOCOO MAX 


ALL3C = COCOO 


HAX HAIT = 


00333 


LP 


INUSE = 


000C1 


HAX 


ALLOC = nnnnn 


HAX 


HATT = 


nnnnP 


H 






AP INUSE = 


CCOOO MAX 


ALLOC = OC^CO 


MAX HAir = 


33330 


HP 


INUSE = 


00030 


HAX 


ALLOC = pnonn 


HAT 


HAT'f = 


r^(\rr\r\ 


H 






PP INUSE = 


OnCOC MAX 


ALLOC = CCOCC 


HAX tlAir = 


00000 


NP 


INUSE = 


00031 


HAX 


ALLOC = M(\(^f^ 


HAT 


HATT = 


ri^r\rr 


H 






VF INUSE = 


rircC2 HIAX 


ALLOC = OCCOO 


HAX i(AXr = 


00030 


VP 


INUSE = 


00330 


HAX 


ALLOC = PPPPP 


HAX 


WAIT = 


l^rrr^f 


H 






00004 VTAB EUFFEH 


POOL USE - 


DAY 119 TIME 


02:03:b3 




















H 






SF IHUSE = 


OCOOC MAX 


ALLOC = CCOCO 


MAX KAir = 


00033 


LF 


INUSE = 


OOOOC 


HAX 


ALLOC = OniPP 


HAX 


HAT'' = 


nnnpp 


H 






SP INUSE = 


00000 HAX 


ALLOC = cccro 


MAI HA IT = 


00000 


LP 


INUSE = 


C0D01 


MAX 


ALLOC = POPPI 


MAT 


WAIT = 


opppri 


H 






AP INUSE « 


OOOOC MAI 


ALLOC = COCCO 


HAX MALI = 


oooao 


HP 


INUSE = 


COOOC 


MAX 


ALLOC = ''(^W^ 


HAX 


HAIT = 


rrori^ 


H 




• 


PP INUSE = 


00000 HAX 


ALLOC = OCOOO 


MAX WAIT = 


00333 


NP 


INOSE = 


00001 


RAX 


ALLOC = Prtnnn 


HAX 


HAT-f = 


ppppp 


H 






VF I NOSE = 


00002 HAX 


ALLOC » 00000 


HAX MAIT = 


00330 


VP 


INUSE = 


00030 


HAX 


ALLOC = ponno 


HAX 


HAI'' = 


(\pr^nn 


H 




* 


00005 VTAH BUFFER 


POOI USE - 


DAT 119 riHE 


02:03:36 




















H 




• 


SF iimsE ■ 


00000 IIAX 


ALL3C = OOOCO 


HAX NAIT =■ 


00000 


LF 


INOSE = 


00007 


HAX 


ALLOC » PPPPT 


RAX 


HAIT = 


(\p(<(\o 


H 






SP IVOSE • 


00000 RAX 


AltDC = 00000 


RAX HAII = 


00900 . 


LP 


IMSE « 


00001 


RAX 


ALL3C « onoon 


HAX 


WAIT « 


ofinnn 


H 




* 


IP HOSE » 


00000 HAX 


ALLOC « 00000 


HAX HAII - 


00330 


■P 


imSB ' 


ooooo 


BU 


AttOC - OOOPO 


HA I 


HAIT - 


POOOO 


^M 




hbhhi 


BB 




BB 


H 


■ 


HI 


■ 


■ 




■ 






■ 



/if ^ 



An example showing the output of the VTAM Pool Use Trace (without networking) 



-J 
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With networking (ACF/VTAM): 

On each entry a 166-byte buffer is written to tape. The record contains: 

1 byte - the EBCDIC character Q 

3 bytes - a sequential count of records 

8 bytes - a clock value from STCK (zero if not set) 

154 bytes - eleven entries in the format: 
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POOLID 
INUSE 
MAXBF 
MAXQD 

NUMEX 
MAXTO 
TOTNO 



2 bytes 
2 bytes 
2 bytes 
2 bytes 
2 bytes 
2 bytes 
2 bytes 



EBCDIC 

binary 
binary 
binary 
binary 
binary 
binary 



values from 
pool control 
block 




When to use 

Use the VTAM Pool Use Trace to refine storage; pool initialization parameters. 



P3^'0 i/r/iM u... 



o 



PDAREA 

007E20 
007E40 
007E60 

ooi&eo 

007EA0 
007EC0 
007EE0 
007F00 
007F20 
007F40 
007F60 
007F80 
07FA0 
007FC0 
007FE0 
008000 
008020 
008040 
008060 

ooa^-.i 

008 

00 8 *»*^ 

0080EO 

008100 

008120 

008140 

008160 

008180 

0081A0 

0081C0 

0081E0 

008200 

008220 

008240)/ 

008260 

008280 

0082A0 

0082C0 

0082EO 

008300 

008320 

008340 

008360 

008380 

0083A0 



004000E0 0100E140 FFFFFFFF FFFFFFFF 
00000000 00000000 00000000 OOOOOOOO 



00000000 OOOOOOOO OOOOOOOO OOOOOOOO 
000012E4 00009A46 00000B62 Q00088BC 
D7C4C1C9 C4E5E3E6 FFFF0009 FFFFFFFF 
010 2 30 40FFFFFF FFFFFFFF FFFFFFFF 
9531008B 47809076 9535008B 077A58B0 
92.61078A 95109261 078A9520 9261078A 
45A09220 92E58000 D2018001 008AD207 
07000700 07005870 00144870 705A1A7C 
926245A0 920492E2 8000BE17 80059200 
004092FF 8010D203 80118010 94308001 
41A10000 41780.008 47F091AC 50A0905C 
800100BA D20F8003 003892FF 801392FF 
917A95FF A0004780 91E241AA 000847F0 
438A0002 89800003 53A00080 58A0A024 
47E0alE2 1B88BF87 700158BA 0020198B 
5A8B003C BE877001 47F091E2 BFB7B045 
00155980 925847D0 91F65880 92505080 
49B09036 47809220 49B09038 47809220 
D502B003 925C4780 91FED501 B00692SF 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO C4000000 00000200 



rt-^^-^/vi-*-^ 



-A 



OOOOOOOO OOOOOOOO 
OOOOOOOO 00004218 
FFFFOOCF FFFFFFFF 
FFFFFFOO 8000422E 
00809500 B0454770 
95309261 07BA9540 
80030020 9001800B 
D2018013 700247F0 
80044028 0002D200 
91201006 47E091E2 
D2019262 00BA45A0 
801458A0 001448A0 
916295FF A0024780 
418A8000 58A80000 
474091D4 41AB0048 
477091B6 D7027001 
92549878 924858A0 
49B0903A 477091FE 
478091FE 90789248 



0012 6B240080 OOOOOOOO 

126S1SIC6 F1E50035 070C1000 001261C0 00000023 001265C8 

0000123lU 9AOO_0000 000011E8 E8C6F1E5 0031070C_ 00000014 
64C8C6Fl |Eam)0CF|O01C66BO|O00OB64 8 OCOOOOOOI FFFFFFFF 

001C2D08 0000005D 001C2EA8 C6F1E500 35070D00 00OOlC2D 

A9C6F1C9 OOCFOOOC 20000001 83C600 Ufc^AA.^*W-^'*0001FFFF 

ICIBBAOO 00005D00 1C1E08C6 F1E500 '/ » J 001C2D08 

C6F1E500 35070D00 00001C2D 520000 V'"- ' ' "'^ A9C6F1E5 

I BBAOOOO 005D001C 1E08C6E1 E5003507 »"*"i>0000 11DB9 C00 

FlfeDajSloVoCOOOO Q01lDB9CJ[000000O0j[_0011ED68|C6FJE5OO 



^R«^ 



uk«. 35»7 0020000/" 126C8400 
^' 0518 00126E/8 C6F1E500 
"^ j^ 07(lp 20000gn.2 6 C8400BO 05880012 
8005880\? 126E: 
3107Wi'-3 OOCylOSB D2 



au *)""* 



^s> 



6EB8C6F1 E5003507 



1C65 40001C64 C8C6F1E2 OOOOCFOO 

OOOOOOFF FFF/FFFF C900tP00 OCOOOOOO 0183C600 02F3080D 

070C0000 00/25F9A 0000CT«00 00178D08 C6F1E500 35070COO 

0000178i'i'c: W«L?i«'D035i\ Lt 0000012 6B240080 05880012 

0D200000 126C8400 8005 J^ 26EB8C6 F1E50035 070D2000 

00126EB8 C6F1E500 3507 *~"**1 000126C 84008005 8800126E 

20000012 6C840080 05880012 6EB8C6F1 E5003507 OD200000 

126EB8C6 FIOOOOOO OOOOOOOO OOOOOOOO 4140006F 9500073D 



000083AF 0000421C 
00003368 00001000 
FFFFFFFF 38DCFFFF 
47F090E2 47F09134 
A00042C0 92619500 
9261078A 50A0905C 
9535008B 477090CE 
91E650A0 905C4020 
8001905C D2078008 
58A1001C BEA78005 
920492C9 8000D201 
A040492A 00004780 
91E24178 O00B1B88 
41AA0OOO 9120A006 
198A4720 91D41B8B 
70015880 92544188 
905C07FA 48B09262 
58B00080 58B0B01C 
58809254 07FA0000 
E750000E E5003507 
00126C84 00800468 
B8C6F1E5 0035070D 
126B2400 80058800 
C6F1E500 35070C00 
890E001C 5B00001C 
"F^ S003S 075D3000 
52000000 5D001C2E 
E5003507 5D200000 
0000005D 001C2EA8 
0035075D 2000001C 
OOOOOOOO 11ED68C6 
35070D20 0000126C 
05880012 6EB8C6F1 
070D2000 00126C84 
8800126E B8C6F1E5 
OD000OOg_126B2 400 
SQQQQO.QOlfriagSOO 



1C66BOO0 00000008 
00005FFF FFE50035 
0000125F 9A000000 
6EB0C6F1 E5003507 
00126C84 00800588 
B8C6F1E5 0035070D 
126C8400 80058800 
4780B8A6 9200073D 



^PDAIDV 



.y ^»M 



N. 



.N. 



S. , DUMNXS.. .V. . . 

F IV 

FIV , FIV 

, Fl V 

. . .FIV / HFIV 

VYFIV $. . . 

.HFIS V 

FIV 

.FlI F.. 3 V 

FIV 

FIV FIV 

FIV F 

IV FIV 

FIV Fl 

V FIV 

FIV FIV 

FIV ,. . 

FlI 3 V. 

K HFIS 





FIV. .. 


. . . .F IV. . . . 


FIV. .. 


. . . .FIV. . . . 




. . .FIV. . . . 


Fl V 


1 






An example showing a dump of the alternate area used for a VTAM trace in core-wrap output mode 
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The PD area 

The PD area is located in the supervisor and consists of four separate parts 
described below: 

1. PD Address Table 

This table is built up during system generation if the system is to support 
PDAIDS. It contains the addresses of the supervisor hooks that provide the 
interface between the PDAID routines and the supervisor. 

2. PD Standard Preface Table 

This table is built up by the PDAID initializing phase, and is used by the PDAID 
event handling routines. 

3. PDAID Event Handling Area 

This area is occupied by the PDAID event handUng routines specified by the 
type of trace requested by the operator. 

4. PD Buffer Area. 

This area is used in the following two ways: 

When core-wrap output mode in the PD area is specified it is used as a rotating 
buffer which preserves events (trace entries). PDAID event handling routines 
use this area as temporary storage for events. This storage area is called the 
trace table. Data is transferred from this table to an output area, which is either 
printed out or dumped on a tape unit, depending on the output device selected 
for the trace routine. 






J 



Locating the PD area 

The start address of the PD area can be located by: 

1. Using any dump containing the supervisor area to find the address of SYSCOM 
(system communication region) in bytes X'80' to '83' of low address storage. 
(See &2 in this Section .) 

The address contained in bytes X'48' to '4B' (label PDARPTR) of SYSCOM 
contains the address of the PD area. 

2. Using the supervisor Hstings to find the address of the label PDAREA. This 
label is the name given to the first byte of the PD area. 

Dumping the PD area 

The easiest method is to use the PD AREA operand of the DUMP command. (See 
A-1 in this Section.) Alternatively, any dump of real storage that includes the 
supervisor area will also include the PD area. 
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o 
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PDAIDS 



Virtual Storage 



Label 

PD AREA 



\ 



LOW ADDRESS STORAGE 



SUPERVISOR 



PD AREA 



PAGE POOL 
unless it belongs 
to BGR 













PD Address Table 




PD Standard 




Preface Table 




PD Event 




Handling 




Routine area 




SL0T1 


nextwrapadrJ 




PD Buffer 




Used for core-wrap 




,, output, or PDAID 




event handling. 



For details of 
contents, see 
Appendix A. 



PD buffer, wlien 
used as core-wrap 
output mode. 






Las;t 12 bytes in PD 
Event Handling Area 



Note: See Section 4 for details about the supervisor organization. 



FIRST entry. 



NEXT entry. 



LAST entry. 



Trace type. 



Input/output 



Fetch/load 



GSVC 



QTAM 



VTAM 



SL0T1 



Contains address of 

FIRST entry in PD 

Buffer. 

It is found at: 



PDAREA -I- 184 



PDAREA + E8 



PDAREA +X'114' 



PDAREA -t-X'ICO' 



PDAREA + X'268 



NEXT 



Contains address of 
NEXT available entry 
in PD Buffer: 
It is found at: 



PDAREA + 188 



PDAREA + EC 



8 = A +4 



B = A +4 



8= A +4 



WRAP ADR 



Contains address of 

LAST entry in PD 

Buffer. 

It is found at: 



PDAREA + 1BC 



PDAREA + F0 



C = A -I-; 



C= A+: 



0= A + 



Length of one 
entry in bytes; 



18 (dec) 



22 (dec) 



18 (dec) 



21 (dec) 



21 (dec) 




Maximum number 
of entries in the 
minimum PD area 
of 1400 bytes (dec) 



52 



52 



61 



44 



36 



Notes: 

i. NEXT - address of the next available entry in the PD Buffer. The NEXT entry 
in the PD Buffer contains either the oldest entry in the table, or the most recent 
entry of device, SVC, or partition being ignored (all entries are placed in the 
NEXT en try before they are checked for trace or ignore). If the latter is the 
case ignore the entry. 

For the VTAM trace NEXT address of the next available slot and the oldest entry in the table. 
(No unwanted entries are made.) 
2. When the LAST entry isfdled, the address in SLOTl is loaded into NEXT and 
the buffer is overwritten by new entries. 

Table B-3 Trace entry locations and lengths for core-wrap output mode in the PD area. 
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Initiating the PDAID trace routines 

You can initiate PDAID trace routines by using standard DOS/VS job control 
language from either SYSLOG or SYSIPT. The statement 

//EXEC PDAID 

causes the main phase (PDAID) to be loaded at the address of the initiating 
partition. Control is given to the PDAID for further specifications to indicate 
the type of trace to be performed. 

The options and control statements for the trace routines may be entered through 
SYSLOG or through the device assigned to SYSIPT. 

If a card reader is used as SYSIPT, the card deck must be punched as follows; 

Entries may be punched one-per-card, or as multiple entries (separated by commas) 
in a single card. An entry may not be split between two cards. All 80 columns of a 
card may be used, but a card is terminated either by the first blank following an 
entry, or by a GO entry. The last card must be a /* card. 

Note: If an incorrect parameter is read from SYSIPT, corrections are requested on 
SYSLOG. 

When the initializing phase (PDAID) has been loaded, the following message is 
issued on SYSLOG: 

4C10DPDAID= 

The operator must respond to this message with one of the following: 

IT specifies an I/O Trace (See Note 1 .) 

FT specifies an F/L Trace (See Note 1 .) 

GT specifies a GSVC Trace (See Note 1 .) 

QT specifies a QTAM Trace (See Note 1 .) 

VT specifies a VTAM Trace (See Note 1 .) 

VP specifies a VTAM Buffer Pool Trace (See Note 1 .) 

TD specifies the Transient Dump (refer to A-4 in this Section) 

XX Terminates the PDAID presently running. 

Pressing the END or ENTER key indicates that PDAID control statements are 

entered through SYSIPT (see Note 2). 

Notes: 

/. When IT, FT, GT, QT, VT, or VP is specified, the operator must provide 
additional PDAID control statements through SYSLOG. 

2. The END response is valid only for SYSLOG and cannot be used as a SYSIPT 
operand. 

3. Multiple operands or operator responses to PDAID control statements for traces 
with a variable number of functions (such as ignoring SVCsj are not allowed. 
Repeat each parameter with each variable. Repeat each message until either the 
maximum number of variables is reached or an END response is given. 

4. GO terminates the PDAID control input, and the default is taken for any PDAID 
options that are not specified. When you use SYSIPT, GO should be the last 
parameter, and it has no operand associated with it. A /* card must follow the 
GO operand. 



,f^> 
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Selecting the output mode PDA IDS 

Selection of an output device : 

The PDAID message/parameter OUTPUT DEVICE= permits the selection of an 
output device. Specify the device by channel and unit, not by symbolic unit. If an 
output device is specified, PDAID checks the address against the supervisor PUB 
and selects the appropriate phase for the unit type (tape or printer). If the output 
is to be magnetic tape, you must use the PDLIST program after tracing is 
complete to obtain a printout of the tape. 

Selection of core-wrap mode: If an output device is not specified, core-wrap mode 
is assumed. The event trace table (see Table B-3) is in the PD buffer in PD area. 
The number of events (trace entries), contained in this area depends on its size as 
generated at system generation time with the option of the FOPT macro. PD=YES 
or 1400 is the minimum, and 10,240 is the maximum that can be selected. 

The table shown in the previous illustration lists the maximum number of events 
that can be preserved in this area, for each of the four trace routines. If core-wrap 
mode is selected, an alternate area can be used. 
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Specifying an Alternate Area 

An alternate area may be specified for core-wrap output through the message/ ^ | 

parameter AAA= (alternate area address). AAA= and OUTPUT DEVICE= are 'A.^J 

mutually exclusive: when one is specified, the other cannot be used. The 
operator specifies an alternate area by responding to AAA= with nk. 

n should be an even integer but if an odd integer is specified, n+1 is assumed, 
n specifies the number of thousand (1024) bytes to be allocated to the alternate 
area, which is taken from the main page pool. 

After AAA=nk has been entered, one of four messages is printed on SYSLOG: 

1. If the requested size of the alternate area is accepted, the message is 
4C50E ADDRESS OF AAA= xxxxxx 

2. If space could not be allocated from the main page pool, the message is 

4C52ENOSPACE AVAILABLE FOR AAA. PDAID IS TERMINATED 

The size of the page pool must be increased and the PDAID must be 
re-initialized. 

3. If the space requested is larger than the space that can be allocated from the 
page pool, the message is 

4C51D SIZE OF AAA=nK, ADDRESS OF AAA=XXXXXX. END/CANCEL 

If the space allocated is sufficient, the operator need only press the END/ENTER key. 
However, if the space allocated is not sufficient, the operator must respond 
with CANCEL, and the size of the page pool must be increased before 
re-initiaUzing the PDAID. 



4. If a second or duplicate request is made for an alternate area, or if a request is 
made for a PDAID using an alternate area while any SDAID function is running, 
the second request is automatically terminated, and the message is 
4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 
The above message is also issued if a second or duphcate request is made for SDAIDS 



'\_y 



Dumping the alternate area 

The contents of the alternate area is automatically dumped on the device assigned 
to SYSLST upon termination of the PDAID. (See "Terminating core-wrap in an 
alternate area" for details.) However, if a dump of an alternate area is required 
without terminating the PDAID, use the xxxxxx, xxxxxx operand of the DUMP 
command, (See A-1 in this Section for details.) 

Note: If this command is used, the trace output will include the fetch and execute 
of the DUMP transient. Specify the address of AAA in the first operand of the 
command, and calculate the value of the second operand from the value ofnk, 
given in the message 4C51D or specified in the message 4C27D during trace 
initialization. The DUMP command will also cause the alternate area to be printed. 

Use Table B-3 and the dump to locate the oldest and newest trace entries. 



2,68 Serviceability Aids 



Trace Routines 

PDA ID error messages PD A I D S 

PDAID routines issue error messages on SYSLOG if incorrect or duplicate 
parameters are specified, or if selected output devices are not ready. The PDAID error 
messages together with recommended actions for operators and programmers are 
Usted in the DOS/ VS Messages manual. 

The following list is a table of options and control statements for executing the 
trace routines. The statements in the table are shown in the sequence in which 
they must be used. Six flowcharts follow the table of options. These flowcharts 
show how to execute the trace routines. 

Seven examples of initiating trace routines via SYSIPT, followed by six examples 
of initiating via SYSLOG, immediately follow the last of those flowcharts. 
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SYS LOG 

Message 



SYSIPT 
Parameter 



PDAID 



OUTPUT DEVICE 
(see note 3) 



AAA = 
(see note 3) 



TRACE PARTITION= 
(Valid for Fetch/Load, 
SVC, QTAM.and VTAM 
Trace) 



IGNORE DEVICE = 
(See notes 2 and 7) 



TRACE DEVICE- 
(See notes 2 and 7) 



IGNORE SVC= 
(See notes 2 and 7) 



TRACE SVC = 
(See notes 2 and 7) 



GO (Valid SYSIPT 
Parameter) 
(See note 4) 



SYSLOG 
Response 



SYSIPT 
Operand 



FT 

GT 

IT 

QT 

VT 

VP 

TD 

XX 

END 



cuu 
X'cuu' 
END 
GO 




SP 
BG 
Fn 
END 
LL GO J 




cuu 
X'cuu' 
END 
GO 





GO 
(Valid SYSLOG 
Response) 
(See note 4) 



Meaning 



FT — Fetch /Load Trace 

GT - GSVC Trace 

IT - I/O Trace 

QT - QTAM Trace 

VT - VTAM Trace 

VP - VTAM Buffer Pool Trace 

TD — Transient Dump, refer to A-4 in this Sectior 

XX — Terminate present PDAID function 

END - Additional PDAID control input through 
SYSIPT (see Note 5). 



Specify the hexadecimal channel and unit number 
of either a magnetic tape unit or a printer for the 
output device of the PDAID. 
(see note 6) 



The parameter nK specifies the number of bytes to 
be allocated as alternate address area. This area will 
be allocated storage from the main page pool. The 
value n must be an even integer. If it is not an even 
integer, (n+1 ) K is allocated. 



SP - Supervisor 
BG -Background 
Fn - Foreground n 
(see note 1) 



Specify the hexadecimal channel and unit number 
of the device to be ignored by the I/O, QTAM, and 
VTAM trace. A maximum of 3 may be specified. 



Specify the hexadecimal channel and unit number 
of the device to be traced by the I/O, QTAM, and 
VTAM trace. A maximum of 3 may be specified. 



Specify the hexadecimal SVC number to be ignored 
by the GSVC trace. A maximum of 6 may be 
specified. 



Specify the hexadecimal SVC number to be traced 
by the GSVC trace. A maximum of 6 may be 
specified. 



GO terminates the PDAID control input and the 
default is used for those options that are not 
specified. 



Default 



None 



Core-wrap mode. 
(See note 7) 



Co re- wrap 
mode using 
PD area 



Trace all partitions and 
the supervisor. 



Trace all devices. 



Trace all devices. 



Trace all SVCs. 



Trace all SVCs. 



None. 



J 



-.^ 



Notes: /. Fn can be F1 up to the highest numbered foreground partition availabie in the system. Only SVCs and 31 are recorded 
for the QTAM trace, and only SVCs 49 und 53 for the VTAM trace, 

2. The trace and ignore options are mutually exclusive. 

3. The output device and AAA options are mutually exclusive. 

4. GO will generate default parameters. 

5. END means 'Press the END key', or for Models 1 15, 125, and 158 press the ENTER key. 

6. A magnetic tape unit is the only valid output device for the QTAM and VTAM trace. 

7. Not applicable to the Transient dump. 

Table B-4 Options and control statements for executing the PDAID trace routines 
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Operator's 
flowcharts 



//JOB PDTRACE 
//EXECPDAID 



4C10DPDAID= 



Enter XX 
and press 
END key 



Select a 

trace 

function 



Press 
END 
only 



Trace events 
specified by 
the function. 



Terminate present 
trace routine. 



\K 



S 



Read parameters 
from SYSIPT. 



Begin selected trace 



4C11D OUTPUT DEVICE^ 



Enter GO 
and press 
END key 



Press END 
key 



Specify an 
output device 
X'cuu' 



o 



4C27D AAA= 



Enter GO 
and press 
END key. 



Specify a 
value for 
alternate area 



Press 
END 
only 



One of four 
messages is issued 



Assume core 
wrap output 
mode with 
default parameters 



Log trace in 
specified alternate 
area 



Log trace 
in PD area 



Log trace on 
specified device 



PDAIDS 
Initializing PD AIDS part 1 of 7 



IT - I/O Trace 
FT- Fetch/Load Trace 
GT- GSVC Trace 
QT- QTAM Trace 
VT - VTAM Trace 
VP - VTAM Buffer Pool Trace 
l^ TD - Transient Dump (A-4-F) 




Specify the hexadecimal channel 
and unit number of either a 
magnetic tape unit or a printer 
for the output device of the 
PDAID. 

Note: A magnetic tape unit is the 
only valid output device for the 
QTAM and the VTAM trace. 



Specify the number of bytes 
allocated to an alternate area. The 
value must be an even integer, 
otherwise the next higher even 
integer is used. 

For a description of these 
messages and required operator 
responses, see 
Specifying an Alternate Area. 

For an 1/0, F/L, or GSVC trace 
the device is a line printer or 
magnetic tape unit. For a QTAM 
or a VTAM trace the device 
may only be a magnetic tape unit. 



To part 2, 3, To part 2 
4, 5, and 6 



To part 3 



To part 4 



To part 5 



To part 6 



To part 7 



B-4-F 
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PDAIDS 

Initializing PDAIDS part 2 of 7 



From part 1 



From part 1 



>, 
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4C13D IGNORE DEVICE = 



Specify the hexadecimal channel and 
unit number of the device to be 
ignored (X'cuu') and press END key- 
A maximum of 3 may be specified. 



Note 

The trace and ignore options are 

mutuai/y exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced (X'cuu') and press END key- 
A maximum of 3 may be specified. 



Select 

device(s) 

to be ignored 



Press 
END 
key 



Enter 
GO 



4C14D TRACE DEVICE = 



Select 
device (s) 
to be traced 



Ignore these 
devices 
(Maximum of 3) 



Press 
END 
only 



Enter GO 
and press 
END 



Trace only 
these devices 
(Maximum of 3) 



Assume that al 
devices are to 
be traced 



\_.,..^-^' 



Begin trace routine 



Store I/O everats 
in the PD area or 
an alternate area 



Display I/O events, 
by 'dumping' 




//EXECPDAID 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

//EXECPDLIST 

/* 

/& 



I 



Display I/O events 
using this utility 
program 



Display I/O events 
as they occur 
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PDAIDS 
Initializing PDAIDS part 3 of 7 



From part 1 



From part 1 



4C12D TRACE PARTITION = 



Enter GO 
and press 
END key 



Press 
END 
only 



Select 
partition 
to be traced 



Assume that all 

partitions 

are to be traced 



SP - Supervisor 
BG -Background 
Fn - Foreground n 



Trace specified 
partitions 




Begin trace routine 



Display F/L events 
as they occur 




Store F/L events 
in the PD area or 
an alternate area 



// EXECPDAiD 

PDAID=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

//EXECPDLIST 

/* 

/& 



Display F/L events 
using this utility^ 
progra m 



Display F/L events 
by 'dumping' 
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Initializing PDAIDS part 4 of 7 



From part 1 



From part 1 




'1 ,/ 



4C16D TRACE SVC = 



Specify the hexadecimal SVC number 
to be traced by the GSVC trace. A 
maximum of 6 may be specified. 




Press 
END 
only 



Enter Go 
and press 
END key 



Specify the hexadecimal SVC number 
to be ignored by the GSVC trace. A 
maximum of 6 may be specified. 



4C15D IGNORE SVC = 



Specify I Press 

SVC(s) or END 

to be ignored i only 



Enter Go 
and press 
END key 



Trace these SVCs 
(Maximum of 6) 



Ignore only 
these SVCs 
(Maximum of 6) 



Assume that all 
SVCs are to be 
traced 



4C12D TRACE PARTITION = 



SP - Supervisor 
BG- Background 
Fn - Foreground n 



SPECIFY 
partition 
to be traced 



Enter GO 
and press 
END key 



I Begin trace routine 



V^. 



Assume all 
partitions to be 
traced 



Store SVC events 
in the PD area or 
an alternate area 




//EXECPDAID 

PDAID=XX 

/• 

// ASSGN SYSOOB.X'cuu' 

//MTCREW,SYS005 

// EXEC PDLIST 

/• 

/& 



Display SVC events 
by 'dumping' 



Display SVC events 
using this utility 
program 



Display SVC events 
as they occur 



,/ 
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From part 1 



From part 1 



PDAIDS 
Initializing PDAIDS part 5 of 7 



4C1 3D IGNORE DEVICE 



Select 
device(s) 
to be ignored 



Press 
END 
only 



Enter GO 
and press 
END key 



4C14D TRACE DEVICE 



Press 
END 
only 



Select 
device to 
be traced 



Enter GO 
and press 
END key 



Ignore 
these 

devices (Max. 
of 3) 



Assume all 
devices to be 
traced 



Trace only these 

devices 

(Max of 3) 






4C12D TRACE PARTITION^ 



Press 
END 
only 



Enter GO 
and press 
END key 



-^C 



Specify 
Partition 
to be traced 



Assume all 
partitions to 
be traced 



Specify the hexadecimal channel and 
unit number of the device to be 
ignored X'cuu' and press END key 
A maximum of 3 may be specified. 

Note: The trace and ignore options 
are mutually exclusive. 



Specify the hexadecimal channel and 
unit number of the device to be 
traced X'cuu' and press END key. 
A maximum of 3 may be specified. 




SP Supervisor 
BG Background 
Fn Foreground n 



Assume all 
devices and all 
partitions to 
be traced 



J 




Begin trace 
routine 



// EXECPDAID 

PDA1D=XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

// EXEC PDLIST 

/* 

/& 



T 



Display QTAM 
events using this 
utility program 



Store QTAM 
events in 
PD area or an 
alternate area 

I ; 



Display QTAM 
events by 'dumping' 
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Initializing PDAIDS part 6 of 7 



From part 1 



From part 1 




4C13D IGNORE DEVICE = 



Specify the hexadecimal channel and 
unit number of the devices to be 
ignored X'cuu' and press EIMD key. 
A maximum of 3 may be specified. 



Note: 

The trace and ignore options are 

mutually exclusive. 

Specify the hexadecimal channel and 
unit number of the device to be 
traced X'cuu' and press END key. 
A maximum of 3 may be specified. 



Select 

device (s) 

to be ignored 



Press 
END 
only 



Enter GO 
and press 
END key 




4C14D TRACE DEVICE = 



Select 
device to 
be traced 



Enter GO 
and press 
END key 



Ignore 
these 

devices (Max. 
of 3) 



Assume all 
devices to be 
traced 



Trace only these 
devices 
(Max of 3) 



r 



4C12D TRACE PARTITION = 



SP Supervisor 
BG Background 
Fn Foreground n 



Press 
END 
only 



or 



Enter GO 
and press 
END key 



or 



Specify 
Partition 
to be traced 



Assume all 
partitions to 
be traced 









Assume all 
devices and all 
partitions to 
be traced 




Begin trace 
routine 



//EXECPDAID 
PDAID=XX 

/* 

// ASSGN SYS005.X'cuu 

// MTC REW,SYS005 

//EXECPDLIST 

/* 
/& 



I 



Store VTAM 
events in 
PD area or an 
alternate area 



Display VTAM 
events using this 
utility program 



Display VTAM 
events by 'dumping' 
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Initializing PDAIDS part 7 of 7 




//EXECPDAID 

PDAID-XX 

/* 

// ASSGN SYS005,X'cuu' 

// MTC REW,SYS005 

// EXEC PDLIST 

/* 

/& 







Display the VTAM 
buffer pool entries 
using this utility 
program 
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The following eight examples show job streams to initiate trace routines through 
SYSIPT. 

Example 1 — I/O Trace Function (single entry per card): 

//J0BCARDINP1 

//EXECPDAID Calls for initializer. 

PDAID=IT Calls for I/O trace function. 

AAA=2K Specifies alternate save area. 

IGNORE DEVICE=190 Ignores events from 190. 

IGNORE DEVICE=191 Ignores events from 191. 

GO Signals end of input. 

/* 

/& 

Note: No output device is specified; therefore, core-wrap is selected by default. 
To obtain the data held in the alternate area, SYSLST must be assigned to either 
a line printer, tape unit, or disk drive. Exercise care, therefore, during termination 
ofPDAID. 

For example: 

//ASSGN SYSLST, X'19r 
//EXECPDAID 

ensures that the alternate area is dumped on device 191 before responding XX to 
the message 4C10D PDAID=. 

Example 2 — I/O Trace Function (multiple entries): 






//J0BCARDINP2 

//EXECPDAID 

PDAID=IT, IGNORE DEVICE=OOE, 

OUTPUT DEVICE=180, 

GO 



/* 

//EXEC ASSEMBLY 

Source 

Deck 

/* 

//EXECPDAID 

PDAID=XX, 

/* 

// ASSGN SYS005,X' 180' 

//MTCREW,SYS005 

//EXECPDLIST 

/* 

/& 



Calls for initializer. 



Calls for I/O trace function. Specifies that 
the function ignore interrupts from OOE and 
record I/O events on 180. (Assume 180 is a 
taoe unit) Signals end of input. 

I/O activity of assembler will be traced; 
output will be on tape drive 180. 



Terminates I/O trace function. 

Assigns tape to S YS005 . 

Rewind the tape. 

Print out contents of tape on the printer 

using the PDLIST program. 



H;._„-/ 



Tape is formatted and listed on SYSLST. 
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//J0BCARDINP3 

// EXEC PDAID 

PDAID=FT 

TRACE PARTITI0N=F2 

TRACE PARTITION=BG 

GO 

/* 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Trace foreground 2 partition. 
Trace background partition. 
Signals end of input. 



Note: Because no output device (OUTPUT DEVICE=) is specified, core-wrap is 
selected by default. 



Example 4 — Fetch/Load trace Function: 



//J0BCARDINP4 

//EXEC PDAID 

PDAID=FT 

OUTPUT DEVICE=OOE 

GO 

/* 

/& 



Calls for initializer. 
Calls for F/L trace function. 
Specifies printer output. 
Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 



Example 5 — GSVC Trace Function: 

//J0BCARD1NP5 
//EXEC PDAID 
PDAID=GT 

OUTPUT DEVICE=OOE 
TRACE PARTITION=BG 
TRACE PART1TI0N=F2 
TRACE SVC=01 
TRACE SVC=04 
GO 

r 
/& 

Example 6 — QTAM Trace Function: 

//J0BCARDINP6 

//EXEC PDAID 

PDAID=aT 

OUTPUT DEVICE=180 

TRACE DEVICE=183 

TRACE DEVICE=OOE 

GO 

/* 

/& 



Calls for initializer. 
Calls for GSVC trace function. 
Specifies printer output. 
Trace background partition. 
Trace foreground 2 partition. 
Trace SVC 1 . 
Trace SVC 4. 
Signals end of input. 




Calls for initializer. 

Calls for QTAM trace function. 

Specifies tape output. 

Trace events on tape drive 1 83 . 

Trace events on printer. 

Signals end of input. 



Note: All partitions are traced if this is a multiprogramming system. 
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Example 7 - VTAM Trace Function : 

// J0BCARDINP7 
// EXECPDAID 

PDAID=VT 

AAA=K 

IGNORE DEVICE=130 

IGNORE DEVICE=OOE 

GO 

r 
/& 



Galls for initializer 

Calls for VTAM trace function 

Specifies alternate save area 

Ignore SIO and I/O interrupts on drive 1 30 

Ignore SIO and 1/0 interrupts on printer 

Signals end of input 






Note: Because an output device is not specified, core-wrap mode is selected 
by default. 



Example 8 - VTAM Buffer Pool Trace Function: 



// J0BCARDINP8 
// EXECPDAID 

PDAID=VP 

OUTPUT DEVICE=180 

/* 
/& 

To print this tape: 

// JOB LIST 

// ASSGNSYS005,X'180' 
// MTC REW,SYS005 
// EXECPDLIST 

/* 
/& 



Calls for initializer 

Calls for VTAM Buffer Pool trace function 

Specifies tape output 



Assigns tape to SYS005 

Rev^^ind the tape 

Print the contents of the tape using the 

PDLIST program 



\„^ 



The following seven examples show job streams to initiate trace routines through 
SYSLOG. 

Example 1 — Store all I/O events in core using PD area for tables: 



//J0BTYPINPT1 
//EXECPDAID 
4C10DPDAID= 
IT and press END 
OUTPUT DEVICE= 
GO and press END 



Calls for initializer. 
Console requests function. 
Operator response: I/O trace function. 
Console requests output device. 

Operator response: end of input (PD area 
is used for output). 

Note: Because no output device is specified, core-wrap mode is selected by default. 
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Example 2 — Trace I/O events from three specified devices, using printer ouiput: 



Trace Routines 

PDAIDS 



//J0BTYPINPT2 
// EXEC PDAID 
4C10DPDAID= 
IT and Press END 
OUTPUT DEVICE= 
OOE and press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 

180 and press END 
TRACE DEVICE= 
090 and press END 
TRACE DEVICE= 
01 F and press END 

Note: GO does not have to be specified here. The initializer knows this is the end 
of input because three TRACE entries have been made. 

Example 3 - Trace only the background partition and store the F/L events in the 
PD area: 



Calls for initializer. 
Console requests function. 
Operator response: I/O trace function. 
Console requests output device address. 
Operator response: printer output. 
Console requests IGNORE parameters. 
Operator response: no devices to be ignored. 
Console requests devices to be traced and 
the operator specifies them. 



// J0BTYPINT3 
//EXEC PDAID 
4C10DPDAID= 
FT and press END 
OUTPUT DEVICE= 
Press END 
AAA= 
Press END 

TRACE PARTITION^ 
BG and press END 
TRACE PARTITION^ 
GO and press END 



Calls for initializer. 

Console requests function. 

Operator response: F/L trace function. 

Console requests output device. 

Operator response: core-wrap mode. 

Console requests alternate area. 

Operator response: no AAA; store events in 

PD area. 

Console requests partition to be traced. 

Operator response: background. 

Console requests second partition. 

Operator response: end of input. 
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Example 4 
on printer. 



Trace all SVC s in both foreground partitions and list events 



//,J0BTYPINPT4 

//EXECPDAID 

PDAID= 

GTand press END 

OUTPUT DEVICE= 
OOE and press END 
TRACE PARTITION = 
F1 and press END 
TRACE PARTITION = 
F2and press END 
TRACE PARTITION = 
Press END 

IGNORE SVC= 
Press END 
TRACE SVC= 
GO and press END 



„./ 



Calls for initializer 

Console requests function 

Operator response. Generalized SVC trace 

function 

Console requests output device 

Operator response: Printer output 

Console requests partition to be traced 

Operator response: foreground 1 

Console requests second partition to be traced 

Operator response: foreground 2 

Console requests third partition to be traced 

Operator response: no more partitions 

to be traced 

Console requests first SVC to be ignored 

Operator response: No SVCs to be ignored 

Console requests first SVC to be traced 

Operator response: Trace all SVCs: end of input 



Example 5 - Trace interrupts on tape drive 180 and printer OOE using the 
QTAM trace function and store the events in the PD area: 



//J0BTYPINPT5 
//EXECPDAID 
4C10D PDAID= 
QT and press END 
OUTPUT DEVICE= 
Press END 
AAA= 
Press END 
IGNORE DEVICE= 
Press END 
TRACE DEVICE= 
180 and press END 

TRACE DEVICE= 
OOE and press END 

TRACE DEVICE= 
Press END 

TRACE PARTITION^ 
F4and press END 
TRACE PARTITION^ 

Press END 



Calls for initializer. 
Console requests function. 
Operator response: QTAM trace. 
Console requests output device address. 
Operator response: PD area. 
Console requests alternate area. 
Operator response: no alternate area. 
Console requests device to be ignored. 
Operator response: no device to be ignored. 
Console requests device to be traced. 
Operator response: Trace interrupts on 
device 180. 

Console request second device to be traced. 

Operator response: trace interrupts on device 

OOE. 

Console requests third device to be traced. 

Operator response: no third device; end of 

input. 

Console requests first partition to be traced. 

Operator response foreground 4. 

Console requests second partition to be 

traced. 

Operator response: end of input. 
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Example 6 — Trace SIO and 
using VTAM trace function, 

// J0BTYPINPT6 
// EXECPDAID 
PDAID= 

VTand press END 
OUTPUT DEVICE= 
Press END 
AAA= 

2Kand press END 
IGNORE DEVICE= 
130 and press END 
IGNORE DEVICE= 
OOE and press END 
IGNORE DEVICE= 
GO and press END 



I/O interrupts, ignoring disk drive 130 and printer OOE 
and store the events in an alternate area of 2K. 



Calls for initializer. 
Console requests function. 
Operator response: VTAM trace. 
Console requests output device address. 
Operator response: core-wrap mode. 
Console requests alternate area. 
Operator response. 

Console request for device to be ignored. 
Operator response: ignore disk drive 130. 
Console request for device to be ignored. 
Operator response: ignore printer. 
Console request for device to be ignored. 
Operator response: End of input. 
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Example 7 — VI AM Buffer Pool trace to tape 



// J0BTYPINPT6 

// EXECPDAID 

PDAID= 

VP and press END 

OUTPUT DEVICE= 
180 and press END 



Calls for initializer. 

Console requests function. 

Operator response: VTAM Buffer Pool 

Trace. 

Console requests output device address. 

Operator response: output to magnetic 

tape unit 180. 
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PART 2 SDAIDS 



General description 

SDAIDS provide further tracing facilities to supplement those already provided by 
the PDAIDS. While the PDAIDS produce a predefined output for each type of 
trace, as described in Part 1 of this Section, most of the SDAID trace functions can 
be initiated to produce information that is more defined for a given type of system 
malfunction. The SDAID printout ranges from one printed line for each event up to 
a dump of the complete real storage for each event. (No events will be lost as 
they may be with PDAID output.) SDAIDS also provide special dumping 
facilities that enable non-destroying dumps to be executed on the occurrence of 
specific events during program operation. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 



G 



The SDAID trace functions are as follows: 

1 . A page trace, consisting of 

• a page translation exception trace (when a page fault occurs) 

• a page enqueue trace (when a page is placed in the page queue) 

• a page handling trace (when a page is removed from the page queue) 

2. An instruction trace that records instructions in the order in which they are 
executed between any selected addresses. 

3. A main storage alter trace that records the address of the instruction that 
altered the contents of any or all byte locations between any selected 
addresses. 

4. A general register alter trace that records any alteration made to any one, or 
any selected, general registers. 

5. A successful branch trace that records the address at which a successful branch 
is made, between any selected addresses. 






The stop and dump facilities are: 

1 . Stop on event: On the occurence of one or any of the following specified 
events, all system activity is suspended after SDAID output is complete. 



at any specified instruction address 

on alteration of any byte location between any selected addresses 

on alteration of one or more specified general registers 

on any successful branch that occurs between any selected addresses 

on the occurrence of a page translation exception 

on the occurrence of a program check code X'OI'-X'IO' and X'12' 

on the occurrence of a request for a page to be placed in the PG queue 

(page fault enqueued). 

on the occurrence of a request for a page to be removed from the PG 

queue by the page handler. 
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2. As well as being able to obtain a dump of areas specified by the output class at SDAI DS 

the; stop event, it is possible to obtain a dump of real and virtual address areas- 
after the specified output class has been dumped. 

The types of dumps that can be obtained in this way are: 

• Non-destroying dump: This is a dump of all real storage. It can be obtained if 
required after a stop on event. The dump is non-destroying because system 
status information is preserved, thus enabling system operation to continue 
after execution of the dump. 

• Dump on a program check: On the occurrence of a program check interrupt 
(codes X'Or to X'OF', X'lO', and X'12'), a non-destroying dump of the 
complete supervisor area is automatically executed. 

• PDUMP: Enables a dump of a minimum area of 32 bytes (one print line) 
between two virtual address limits. The maximum area that can be dumped 
depends only on the size of virtual storage, and only virtual address 

area information that is in, real storage is^dumped. , . 

System requirements 

The SD area need not be specified during system generation, but the SDAID initial- 
izing and terminating programs must be cataloged in the core image library. 

SDAIDS make use of program event recording and monitoring, described in 
Appendix E. 

Output from all SDAIDS routines is directed to a line printer. The line printer is 
non -dedicated, meaning that the same printer may be used as an output device for 
other programs as well as for the SDAIDS. Therefore, SDAID output may be 
interspersed with job output. 

Note: the following restriction, if the printer is connected via a selector or block 
multiplexer mode channel: 

No other devices must be running on the same channel as the printer at the moment 
when SDAID attempts to write to the printer. 
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SDAID Characteristics 

• SDAIDS reside in the SD area, which must occupy at least 6K bytes of the 
real address area. 

The storage assigned to the SD area is taken from the page pool. 

• SDAID is initialized by // EXEC SDAID, and requires 1 2K of a real or virtual 
partition (only during initialization of any SDAID function). Parameters, 
specified either at initialization time or later, must be entered on the console. 

• After initialization, SDAID does not use DOS/VS services. 

• SDAID has immediate control in case of a program check interruption. 

• SDAID runs with DAT (Dynamic Address Translation) off, disabled for I/O and 
external interrupts. 

• After SDAID handled event, processing continues as if event handling had not 
occurred. 

• Only the contents of the real address area is dumped with SDAID. (Pages that 
currently reside only on the page data set will not be dumped.) 

• SDAID may not be used to debug time-dependent programs because it runs 
disabled while recording events and thus delays processing. 

• Because SDAIDS use the program event recording PER facility, and because 
time is required to print SDAID output, program execution time is increased. 
Its effect on the operation of time-dependent programs must therefore be 
considered before using this serviceability aid. Performance degradation when 
using SDAIDS will be reduced when the FASTREC output class is selected. 

• Debugging of printer error recovery routines is possible only if the FASTREC 
output class is used. 

• If, during the printing of SDAID output, the Une printer is stopped for any 
reason or becomes not ready, the system will enter a wait state with a message 
in low address storage. To continue printer operation, press the EXTERNAL 
INTERRUPT key. 

• When initialization is complete, the event handling routines within the SDAID 
initiating program partition are transferred to the SD area. The 12K partition 
can then be re-used, but the pages occupied at the end of the page pool by the 
SD area are not released for normal program use until all SDAID functions are 
terminated. 
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Terminating the SDAID routines 

The tool SDAID is terminated, and the SD area is released to the page pool by 

one of the following: 

1 . The AR (attention routine) command ENDSD 

2. The job control statement // EXEC ENDSD 

Note: Depending on the events being traced and the event limits specified, it may 
take some time before the attention routine or job control becomes active. One 
method to avoid this delay is to clear control register 9 using the ALTER /DISPLAY 
console feature before requesting the attention routine. 
This de-activates all PER event tracing. 
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Using SDA ID and PDA ID concurrently 

If the system has been generated to accept PDAIDS, any one of the PDAID trace 
routines may run concurrently with SDAID. However, if the PDAID currently 
running is using an alternate area, it must first be terminated before an SDAID 
routine can run. 



\J^ 



SDAID Events 

SDAID events are recognized as program checks. There are two groups of events: 
elementary events and dedicated events. 

Elementary events are: 



Mnemonic 


Event 


BR 

IF 

SA 

GA 

TE 


successful branching 
instruction fetching 
storage alteration 
general register alteration 
page translation exception 



Dedicated events are: 



Mnemonic 


Event 


PGMCHK 

PAGENQ 
PAGEHDL 


program interruption codes 
X'Or-X'OF' and X'10', X'12' 
request for page is enqueued 
request for page is handled 




SDAID output information 

When an event occurs, the SDAID event handling routines will record either the 
information specified by output class parameter (for elementary events), or 
predefined data (for dedicated events). 

By using the output class parameter of the SDAID operand OUTCL= the amount and 
and type of information required for offline program debugging can be selected for 
the elementary event during initialization of the SDAIDS. After initialization, the 
output class can also be re-specified if required. 

For elementary events the output class can be specified according to Table B-6-A. 
However, if more than one elementary event is being traced simultaneously, the 
output class will be the same for all events. For each dedicated event, a 
predefined output is obtained as shown in Table B-6-B. 
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Output if more than one event is being traced: This is desirable when many events 
are to be traced between wide event limits. It decreases the amount of printer 
output and reduces print time. Therefore, the larger the space allotted to SDAID 
during initialization, the larger is the SD buffer area for FASTREC output. 

Events can be enabled individually or in combination with one another. If some or 
all of the events BR, IF, SA, and GA happen concurrently, the output class Hsted 
in Table B-2-A is printed only once. The event ID, however, contains the mnemonics 
of all current events. 

If any of the other events happen concurrently, even if they occur together with 
one of the events BR, IF, SA, or GA, the output is printed for each event that 
occurs. 

PDUMP output class: A PDUMP is triggered by events just as the other output 
classes. It dumps a minimum of 32 Bytes (one print line) between two virtual 
address hmits. The maximum area that can be dumped depends only on the size of 
virtual storage. Any area between the two Hmits, not in real storage, will be 
indicated by a message. 

Any PDUMP limits may be specified. However, the value of the limits in relation 
to the value X'CO' and to each other determines the output. 




No 






Yes 




No 



Dumping to end 
of storage occurs 
(no wrap-around) 



Yes 



SDAID forces 
lower limit of 
000000 



SDAID selects 
output class of 
LOCORE 



Note: Tfie defaults for the PDUMP limits are the EVENT limits (X'llllir, 'hhhhhh ') 
specified in answer to message 4C61D, refer to Table B-10. 
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^"■"-^^^^^^ Output classes 
^~~^-^^,^^ and 
Recorded ^-^.^^^ Mnemonic 
Information ^"""-v,,,^^ 


OUTCL 1 


OUTCL 2 


OUTCL 3 


OUTCL 4 


OUTCL 5 


OUTCL 6 


OUTCL 7 


OUTCL 8 


OUTCL Q 


PSW 
01 


GPR 
02 


LOCO RE 
03 


COMREG 
04 


PAGETAB 
05 


SUPVISOR 
06 


DUMPREAL 
NDD07 


PDUMP 
08 


FAST R EC** 
00 


Event ID* 

program old PSW, and time of day 

in microseconds 


X 


X 


X 


X 


X 


X 


X*- 


X 


X 


Instruction causing event 


X 


X 


X 


X 


X 


X 


x-» 


X 




General purpose registers 




X 


X 


X 


X 


X 


X 


X 




Low core (X'OOO'-X'1 1 F') 






X 


X 


X 


X 


X 






Current COMREG and SYSCOM 








X 




X 


X 






Control registers. 






X 


X 


X 


X 


X 


X 




segment tables, 
page tables, 
page frame table 










X 


X 


X 






Complete supervisor 












X 


X 






Complete real address area 














X 






Virtual dump between 
PDUMP address limits 
















X 




TE-MASK 

PER nnask (control register 9) 

GPR mask (control register 9) 

PER start address (control register 10) 

PER end address (control register 1 1 ) 

general purpose registers 1 3, 14, 1 5, 0, 1 , 2 


















X 



Notes 



Event ID for BR, IF, SA, and GA — event mnemonic and instruction address. 

Event ID for TE — mnemonic TE and address of the page causing TE. 

FASTREC is an output class that stores the described information into an SDAID internal buffer. 

Information for several events is stored and printed as one block. 

INSTR and PSW are not printed if NDD is forced after STOP ON EVENT VIA NDD BYTE X'FF'. 



> 



to 

bo 



Table B-6-A . Output class options for SDAID elementary events. 

Examples at the end of this section 2-F show several types of output specified by the output class parameter. 




C/3 
D 
> 

D 
C/3 



o 

C 
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Recorded Information 


Dedicated Event 1 


PGMCHK 


PAGENQ 


PAGEHDL 


Event-Mnemonic 

Program old PSW, 

Time of day in microseconds, 

Complete supervisor, 

Instruction at time of PGMCHK 

Control registers 

General purpose registers 


X 






Event-Mnemonic 

Requestor-ID 

(TE/GETR/TFIX/PFIX) 

Task-ID 

Address of page to be handled 




X 


X 


Protection key associated with 
page to be handled 




X 


X 


Address of page frame 

to which the page is assigned 






X 



Table B-6-B. Predefined output obtained from SDAID dedicated events. 



Specification of area to be traced 

For elementary events, two addresses may be specified during SDAID initialization 
as the start and end addresses of the area to be traced or monitored. These 
address limits are interpreted as virtual addresses if the DAT bit in the PSW is on. 
Address limits are not applicable to dedicated events, for which the SDAID 
program includes all real and virtual address areas. 

If the start address specified is higher than the end address, tracing commences from 
the higher address and continues to the end of virtual storage (the maximum 
address being 16,777,215). Tracing continues from address 000000 up to the end 
address (the lower address specified). This is termed "wrap around tracing". 



V^. 
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Description and operation SDAIDS 

Translation exception trace 

This occurs when an instruction requires a page to be paged in from the page data 
set in order for the instruction to be completed. An example is an MVC instruction 
whose address 1 is in page frame x in real storage, and whose address 2 is in page y 
that is not in real storage. 

When this trace is initialized, any page fault generated because of such an instruction 
is printed along with the instruction and its address that caused the page fault, plus 
the output of the specified output class. 

Page enqueue trace 

This trace enables the sequence to be traced in which programs are calling for 
pages. Page faults caused by translation exceptions will also be traced with 
this routine. 

Page handling trace 

This trace provides information about the sequence in which pages are paged in 
from the page data set. After a page is handled, a trace output is printed. 

When to use: Use this trace if you suspect that the loss of a page, or the sequence 
of page usage by a program, is causing programming errors. This trace gives you page 
management information during program execution. 
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Instruction trace 

This trace records information about the order of instruction execution within any 
selected area of storage during program execution. The amount and type of 
information provided depends on the output class selected during initialization of 
the trace. 



When to use: If an unintended loop develops during program execution, this trace 
can be initiated and the program re-run. During the re-run, a list of all the instruc- 
tions executed within the loop will be traced. This is an efficient method to 
obtain a loop trace. 



Storage alter trace 

This trace records information about instructions that alter one or more locations 
in virtual storage between address limits that can be specified. The amount and type 
of information provided depends on the output class selected during initiahzation 
of the trace routine. 



When to use: If, for example, you suspect 1/0 areas or count locations for loops, 
information obtained from this trace output will show the instructions that are 
altering the areas. The SA trace will not record changes in the contents of locations 
that are changed directly by I/O channel operations. 



General register alter trace 

This is similar to the virtual storage alter trace. It should be used when information 
about changes to any GR during program execution is required to help during 
offline program debugging. Any GR or any combination of GRs can be traced. 



Successful branch trace 

This trace provides a check on the logical path of a program during its execution 
in any selected part of virtual storage. 



When to use: Use this trace if the actual path taken by a program cannot be 
analysed from the program flowcharts and listings. You can also use it to provide 
information about the path taken, for example, by a long loop. 



/'" \ 
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Stop and dump routines SDAIDS 

Stop on event 

This facility stops all system activity on the occurrence of a specified event. At the 
stop on event, the system is held in a wait state. 

Processing continues via external interrupt. 

With the system in this wait state, the operator or programmer can either use 
hands-on debugging aids or obtain a non -destroying dump. 

The specified event can be one or more of the elementary or dedicated events. 

When to use: 

1 . Use this routine if hands-on debugging is necessary on the occurrence of one of 
the specified events. For example, when a change occurs in a general register, 
you may want to look through the program listings to enable you to decide on 
the next step in isolating an error. When the stop occurs, it is also possible to 
initiate another SDAID routine that will provide additional system information 
for offline program debugging. 

2. When no time is available for hands-on debugging, the non-destroying dumps 
obtained when the stop on event occurs will provide a great deal of additional 
information for offline program debugging. 

Stop on address 

This facility provides a stop on address on any specified (real or virtual) address. 
When the stop occurs, the system is held in a wait state, and the operator or 
programmer can use hands-on debugging aids or obtain a non-destroying dump. 

When and how to use: This facility is used under conditions similar to those for the 
hardware stop on address compare, that is, hands-on debugging is to be carried out 
when a program has reached some specific point during its operation. However, this 
aid enables a stop on all SDAID events. 

The stop on address is accomplished by initiating the instruction trace, specifying 
stop on event, and entering the address at which the stop is required as the address 
supphed within the event limit field during initialization of the trace. 
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Non-destroying dump: This is a dump of real storage that can be obtained after 
the occurrence of a specified event during the stop on event. The dump is non- 
destroying because the system is placed in a wait state on the occurrence of the 
specified event, and because SDAIDS do not destroy system status during 
execution of the dump. 

How to obtain the dump: The following procedure describes how to obtain the 
non-destroying dump: 

1 . When the system is in the stop-on-event wait state, locate the real storage 
address of the NDD (non-destroying dump) byte switch. 

The address of this program switch is printed during SDAID initialization. 
Refer to point 3 of the example in this section which shows the SDAID 
initializing output part 2. 

2. To ensure that the wait state is the true stop-on-event wait, use the ALTER/ 
DISPLAY console feature to display the PSW. The instruction address part of 
the WAIT PSW will be OOOOEEEE. 

3. To obtain the dump, set the NDD byte to X'FF', using the ALTER/DISPLAY 
console feature as described in this Section 2-D. 

4. Press the START key and then the EXTERNAL INTERRUPT key. A non- 
destroying dump will be printed and processing continues. 

When the dump is complete, the NDD byte is reset by the SDAID program, and so 
a dump will not occur at the next stop on event. To obtain another dump at any 
following stop, the NDD byte must again be set on. 

Note: The dump can be discontinued by the following procedure: 

1. Make the line printer used as SDAID output device unready. 

2. Now make the printer ready. 

3. Press the EXTERNAL INTERR UPT key two times within one second. 

When to use: This SDAID faciHty enables you to obtain the information needed 
for problem analysis without having to take dumps of real storage at every 
occurrence of an event. Therefore this decreases the amount of paper to be searched 
through during offline debugging. For example you may consider it sufficient 
for offline debugging to take a dump at every twenty seventh occurrence of an 
event. 
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Dump on a program check: On the occurrence of a program check interrupt codes 
X'Or - X'OF', X'lO', and X'12', the following information is dumped automatically: 

Event ID 

Program old PSW 

Time of day in micro seconds 

Control registers 

General purpose registers 

Real storage from byte location to the end of the supervisor area, and the 

contents of the SDAID buffer 
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After this automatic non-destroying dump is executed, the DOS/VS program 
check handler routine will be entered. 

When to use: If PAIDS are not available on your system, the use of the SDAID 
dump on a program check is the only way to obtain a non-destroying dump of the 
supervisor transient area at the time of a program check interrupt. 

The SO area 



o 




Real Partitions 
any. 



( 



SUPERVISOR 



MAIN 
PAGE 
POOL 



SDAI D resident code 
and work space. 

SD Buffer 



SDAREA 
(6K by default) 



END OF 

REAL STORAGE 



END OF 

REAL STORAGE 



Length of each event is 64 bytes. 



Real storage allocation 
before initializing SDAIDS 



Real storage allocation 
after initializing SDAIDS 



How to locate 

The address of the begining of the SD area is printed on the device assigned to 
SYSLST during initialization of SDAID. Refer to page 2.105 for an example of 
SDAID initializing output. 
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Initializing SDAID 

SDAID may be initialized in any real or virtual partition by entering the following 
execute statement via SYSLOG or SYSRDR: 

//EXEC SDAID 

An operator/system dialog follows, beginning with the message: 

4C55D GIVE SPACE FOR SDAID= 

The operator may respond by pressing the END key (which gives a default value of 
6K to SDAID), or he may specify a value nK, where n represents a multiple of 1024 
bytes. The maximum value that may be specified is 999K, If an odd number is 
specified, the value is incremented to the next even number. The SDAID space is taken 
from the main page pool. If the main page pool is not large enough to accept the 
area specified, an area of the size PP00L-16K is automatically taken with a minimum 
of 6K. If the page pool is not large enough to accept the minimum (6K), the following 
message is printed on SYSLOG: 

4C56E INSUFFICIENT SDAID SPACE, REALLOCATE 

The MAP command should be issued before reallocating real partition areas in 
order to increase the size of the page pool before re-initializing SDAIDS. 

The following message will be issued if this is a second request for SDAID space: 

4C70E DUPLICATE REQUEST FOR PDAID AND/OR SDAID 

This message is also issued if PDAID using the core wrap output mode in an 
alternate area is active in the main page pool and a request for SDAIDS is made. 
When the space allocated to SDAID is accepted, a message dialog follows that allows 
the operator to select one or more events to be traced and to specify between which 
address limits of real or virtual storage the events are to be traced. (Even limits 
do not apply to event PAGENQ, event PAGEHDL, and event PGMCHK.) The dialog (^^s 
also enables the selection of a line printer at a device address other than X'OOE', \^ 

which is the device address by default. However, the device must be a line printer. 

An output class may also be specified (refer to Tables B-6-A and B-6-B in this chapter). 
A response of EOB (pressing the END key) to all SDAID messages will give default 
values. 

When the SDAID message dialog is complete, the SDAID initializing outputs part 
1 and 2 are issued to the device assigned as SYSLST. This need not be the same 
device on which SDAID trace output is printed. The SDAID trace output is printed 
immediately after the initializing output on the device at the address specified in 
the reply to message 

4C58D OUTPUT DEVICE= 

(Address X'OOE' is taken as default.) After initialization, the partition used for the 
initiahzation is given back to the main page pool. 

Table B-10 lists all SDAID messages in the order in which they are issued and 
describes the responses. Operator flowcharts follow, and SEb*lD job entry 
examples are shown after the example of the SDAID initiahzing output. 



SDAID messages after initiahzation time 

4C71 1 SDAID FOUND PRTR STATUS CSW SENSE 

This message may be written out on the printer. It is accompanied by the CSW and 
SENSE information if appHcable. It indicates that the previous printer operation 
which was started may not have been completed successfully. 
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Altering SDAID functions and/or address limits after initialization 

When the SDAID is initialized, trace functions and event hmits, where appUcable, 
can be changed by altering the SDAID program parameters directly in storage. 
The contents of the parameters at the addresses printed on part 2 of the SDAID 
initializing output, and of control registers 8, 9, A, and B, must be altered to 
predetermined values. Their values are also printed in the initializing output. 

To make SDAID parameter changes: 

• Press the STOP key, 

• Use the console ALTER/DISPLAY feature to alter the contents of the 
program parameters. 

• Press the START key. 

Note: When SDAID is terminated and later re-initialized, new SDAID parameters 
are printed in the SDAID initializing output. 

Note: SDAID requires SYSLST for the initializing output. Therefore, if you 
intend to change SDAID parameters after initializing SDAIDS, you should ensure 
that the SYSLST device is a line printer on the partition used for SDAID 
initialization. 

A note to programmers 

SDAIDS are primarily designed to be initialized before re-running failing programs. 
If you, as the programmer, are debugging on the system (hands-on debugging), it 
is recommended that you initiate SDAIDS without specifying any events. (Press 
the END key as a response to all SDAID messages.) SDAID is then retained in the 
page pool ready to be activated. The failing programs can then be executed and 
SDAID events made active by entering event parameters directly into control 
registers 8, 9, 10, and 1 1 . For example, altering the contents of the high-order byte 
of control register 9 (by the console ALTER/DISPLAY feature)' enables you to 
activate any one or all of the events BR, IF, SA, and GA. 

You can also specify which general registers are to be traced by entering values 
into the lower 2 bytes of control register 9. Control registers 10 and 1 1 contain, 
respectively, the start and end addresses for the event Umits. The output of the 
MAP command will tell you the partition in which the failing programs reside. 

From the MAP output you can also obtain the addresses of the upper and lower 
limit of the partition, which can then be used as the event limits for the SDAID 
trace. (Note that addresses printed by the MAP command are decimal.) 

If you are unable to use the system for hands-on debugging, you as the programmer 
must specify clear instructions to the operator about the events to be traced and 
the event limits to be used. 
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Message 
Code 


Message issued 
on SYSLOG 


Parameters entered by Operator 


Remarks 


4C58D 


OUTPUT DEVICE= 


X'OOE 


",GO"j 


END/ENTER 




X'cuu' 
130 


4C60D 


STOP ON EVENT= 


NO L' J 


END/ENTER 




4061 D 


EVENT LI MITS= 


X'000000',X'FFFFFF' 


,G0 

:go- 


END/ENTER 


X'llllll', X'hhhhhh': 
Lower and upper limit of virtual 
or real storage to be traced 
with events BR, IF, SA and TE. 
The addresses must be real if the 
program runs in real mode and 
they must be virtual if the pro- 
gram runs in virtual mode. 


X'llllll' 


"X'llllll' 
,X'hhhhhh' 
,G0 


4C59D 


.OUTCL= 


PSW 

GPR 

LOCORE 

COMREG 

PAGETAB 

SUPVISOR 

DUMPREAL 

PDUMP 

Lj 

FASTREC 


\o\i\ 

X'8 

GO 

PG 
AU 
GO 


.GO 

/er and up 
aaaaa' (" 

MCHK 
TOMATI 


per event 
".Upper ev 
.X'bbbbbl 
,G0 

.go] -1 

C f.Gd 


limit .GO 
ent limit .GO 

y r,G6\ •- -^ 


END/ 
ENTER 


Valid output classes for the events 
BR,IF,SA,GA,andTE. 
END/ENTER 

PGMCHK: Causes wrap around 
mode of internal buffer. It is 
written each time a PGMCHK 
event occurs. AUTOMATIC: 
If the internal buffer is full, 
it is written out. 


4C62D 


EVENT BR= 


\:f [■-] 


END/ENTER 




4C63D 


EVENT iF = 


IZ^^M 


END/ENTER 




4C64D 


EVENT SA= 


NO t J 


END/ENTER 




4C65D 


EVENT GA= 


"X'012...EF' r,GCT] END/ENTER 
NO 


Designate the general purpose 
registers to be traced. At least 
one must be specified. 


4C66D 


EVENT TE= 


^^s TgoI 


END/ENTER 




4C67D 


EVENTPGMCHK= 


r^^S TgoI 
NO L^ J 


END/ENTER 




4C68D 


EVENT PAGENQ= 


NO L J 


END/ENTER 




4C69D 


EVENT PAGEHDL= 


YES 
NO 


END/ENTER 





( 
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Note: GO cannot be enterd as a first parameter. If it is, the dialogue is terminated; defaults (underlined) are taken or the parameters 
are ignored by SDAID 

Table B-10. The parameters required to initialize SDAID event tracing. 
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k> 



//JOBSDTRACE 
//EXECSDAID 



Trace Routines 

SDAIDS 
Initializing SDAID, part 1 of 6 



4C531 TOD IN ERROR STATE 

or 
4C541 TOD NOT OPERATIONAL 



Select size of SD area 



4C55D GIVE SPACE FOR SDAJ-D^ 



Enter 
(a value) 



T 

or 




\^' 



4€70E DUPLICATE REQUEST FOR PDAID 
AND/OR SDAID 




No operator response is required to 
either of these messages if they are 
I printed. The time stamp on SDAID 
output will be zero. 

Maximum area you may specify is 999k. 
if n is an odd integer, the value is 
incremented to the next even number. 



This message is issued if SDAID has 
been initiated and not terminated before 
a second request to initiate SDAID is made. 
The duplicate, or second request for 
SDAID is automatically canceled. (This 
message is also printed if a request to run 
a PDAID core-wrap output in an alter- 
nate area is made while SDAID is active). 










< 


■^ 6K \ 
available 




Yes 




1 Yes 


SD area size 
is nK 


SD area size 
is6K 






-^- 







No 



X7 






•[^' 



^Tf^. 



4C58D OUTPUT DEVICE = 



Device X'cuu' must 
be a line printer 



4C56E INSUFFICIENT SDAID SPACE 
REALLOCATE 



Select a device 



Enter 

X'cuu' and 

GO and press END 



I Enter 
or GO 



I Enter V/ | 

or X'cuu' '^ or 

and press END ( and press END I 



Use device 
X'cuu' for 
output 



Press 
END 



Use device 
X'OOE' for 
output 



Use device 
X'cuu' for 
output 



If this message is prmted, the SDAID job 
is terminated. Before re-mitializing 
SDAIDS you must decrease the size of 
real partitions, thus increasing the size 
of the main page pool for the SD area. 



Use device 
X'OOE' for 
output 




B-10 F 



A 
To part 2 




B 
To part 2 
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SDAIDS 

Initializing SDAID, part 2 of 6 



From part 1 



From part 1 







4C60D STOP ON EVENT 



Enter GO | Enter YES 

and press or and GO 

END I and press END 



Enter YES 
and Press 
END 



Press 
END 



No stop 
on event 



Trace events 
across all of 
virtual storage 



Refer to Table B-6-A for a 
description of SDAID output 
classes. 

(FASTREC.GO generates the 
default of PGMCHK). Output 
class for the events PGMCHK, 
PAGENQ, and PAGEHDL is 
predetermined. Refer to 
Table B-6-B 
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Stop 
on event 



Enter GO 
and press 
END 



nr 



Take default 
output class 
of PSW (01) 



To part 3 



Stop 
on event 



No stop 
on event 



.S"^- 



4C61D EVENT LIMITS = 



y ( \ \ V7 



Specify even}: limits and 



Enter GO and 
press END 



Press ) 

end/ 



Trace events 
between limits 
specified 



Press 
END 



Trace events 
between limits 
specified 




Trace events 
across all of 
virtual storage 



4C59D OUTCL =Q^ 



Enter GO 
press END 



Specify an output class and 

— r~ 



Press 
END 



Use output 
class specified 



Press 
END 



Use output 
class specif ed 



Take default 
output class 
of PSW (01) 



To part 3 






Trace Routines 



From part 2 



From part 2 






BR = Successful Branch Trace 




SDAIDS 
nitializing SDAID, part 3 of 6 



IF = Instruction Fetch Trace 



B-10-F 



To part 4 



To part 4 
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SDAIDS 

Initializing SDAID, part 4 of 6 



From part 3 



Enter GO 
and press 
END 



No SA trace 



GA = General Purpose Register Trace 



From part 3 



SA = Storage Alter Trace 







Enter GO 
and press 
END 



Specify GPR(s) to be traced, (in hex) 



Enter GO and 
press END 



"T 

or 



Press 
END 



No GPR trace 



Trace GPR(s) 
specified 



Trace GPR (s) 
specified 



X.../' 




To part 5 



To part 5 
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From part 4 







Enter GO 
and press 
END 



No TE trace 



From part 4 



SDAIDS 
Initializing SDAID, part 5 of 6 



4C66D EVENT TE = 



TE = Page Translation 
Exception Trace 



Enter YES and 



Enter GO and 
press END 



Press 
END 



Trace T E 
events 



Trace TE 
events 




4C67D EVENT PGMCHK 



Enter GO 
and press 
END 



Enter NO and 



Enter GO and 
press END 



Press 
END 



Trace 
PGMCHK(s) 



PGMCHK = Program check trace 



Do not trace 
PGMCHK(s) 



Do not trace 
PGMCHK(s) 






To part 6 



To part 6 



B-10-F 
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Trace Routines 



SDAIDS 

Initializing SDAID, part 6 of 6 

From part 5 



From part 5 



o 



4C68D EVENT PAGENQ = 



Enter GO 
and press 
END 



PAGENQ = Trace of page requests 
as they are placed in the page queue 



Enter Yes and 



Enter GO and 
Press END 



No PAGENQ 
trace 



or 
I 



Press 
END 



Trace 
PAGENQ(s) 



PAGEHDL = Trace of pages as they 
are allocated to a frame in the real 
address area - page request is 
removed from the page queue. 



Trace 
PAGENQ(s) 




4C69D EVENT PAGEHDL 



v...,/' 



Enter YES 
and press 
END 



No PAGEHDL 
trace 



Press 
END 



Trace 
PAGEHDL 



No PAGE- 
HDL trace 



SDAID initializing output parts 1 and 2 are printed at this 
point during the initialization. The example opposite 
shows and explains the meaning of the initializing output. 
Retain this output if SDAID parameter changes are 
intended after initialization 



4C57E SDAID SUCCESSFULLY INITIATED SDAREA=XXXXK 



-V 
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SDAIO FOUNO/ASSUMEO THE FOLLOMING PARAMETERS: 

SDAID START ADDRESS IS • •• HEX 0003E800 

SDAIO END ADDRESS IS ....................... HEX 0003FFFF 

SOBUFFER START ADDRESS IS HEX 0003FOCO 

SDBUFFER END ADDRESS IS HEX 0003FFFF • 

SOBUFFER CAN KEEP THIS NR OF EVENTS .......... DEC 00000009 

PRINTER ADDRESS IS HEX 

OUTPUT CLASS FIELD IS 

STOP ON EVENT 

EVENT LIMITS START • HEX 

END HEX 



5 EVENT BR 

6 EVENT IF 

7 EVENT SA 

8 EVENT SA 



OOOE 
PSW (Oil 
NO 

00000000 
OOFFFFFF 
NO 
NO 



MASK BITS FOR 6ENERAL PURPOSE REGISTERS . 01234S6789ABCDE 



pOQOOOOOOOOOOOOa 



9 EVENT TE 

10 EVENT PGMCHK . 

11 EVENT PAGENO . 

12 EVENT PA6EHDL. 






SDAID initializing output, part 2 



o 




The summary of parameters printed on the line printer 
after successful initialization of any SDAID routine. 



ALL ADDRESSES ARE REAL. 
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batch f;> 

ass^n svs I stf x'OOeL 

// exec s da i d 

4C55D GIVE SPACE FOR SDAID = 

10k 

4C5AE INSUFFICIENT SDAID SPACE» REALLOCATE 

IIOOA READY FOR COMMUNICATIONS. 

map 

AREA K-REAL UPPER LIM 



<t < 



%J>Atl> iep^ig^'^taf^ ?X 






K-VIRT UPPER LIM 



92K 
30K 
lOK 
IGK 
14K 
82K 



i8K 



16FFF 
1E7FF 
20FFF 
237FF 
26FFF 
3B7FF 



3FFFF 



292K 
80K 
80K 
lOOK 
120K 
96K 
6&K 



40000 

88FFF 

9CFFF 

BOFFF 

C9FFF 

E7FFF 

FFFFF 

FFFFF 






NAME 



KENSLOOP 



NO NAME 



> MAP .4Vm4««rt<r , 



allocr flr-14l< 

// exec sdaid* 

4C55D GIVE SPACE FOR SDAID 

10k 

4C58D OUTPUT DEVICE = 

4C60D STOP ON EVENT = 

4C61D EVENT LIMITS = 
X ' 040000 ' 1- X ' 050f f f 
4C59D OUTCL = 









7«e- 



4C62D 

Yes 

4C63D 

ves 

4CA4D 



EVENT BR = 



EVENT IF == 



EVENT SA = 



(.UfXSUi ^S ^ 



4C65D EVENT GA = 

X' 345678' 

4C66D EVENT TE = 

4C67D EVENT PGMCHK 

4CA8D EVENT PAGENQ 

4C69D EVENT PAGEHDL 









'^- y 



4C57E 
II 00 A 

* ^r- 



SDAID SUCCESSFULLY INITIATED 
READY FOR COMMUNICATIONS. 



SDAREA=0010K 



DC 9 



SDfilO ^6^eM0i/i J'**Mneeu4x>^eA^ 



iDOOQlFSOj 
0000F600 




00000000 
00000000 



00000000 
00000000 



C2000000 
00000000 



00000200 
00000000 



80400040 
OOOOFFFF 






I000404EAI 



AC A 
(0004043C 

DC 9 _ 

D0001F80 >OOO4O43Ct » K)604T>4E(U, 00000000 00000000 C2000000 00000200 80400040 
O000F600 FFFFFFFF jFFFFFFFF^ 00000000 00000000 00000000 00000000 OOOOFFFF 



F2 



SMfd 



AC 9 
00000000 



Cj&€t^ CA f ^ /u^ «^^ Ct»««^, e«c-<t^^/f tH^cn/C ^' 



^cm 



The example above shows the operator-system dialogue on a 3215 PRKB during SDAID initialization. 

After initialization the contents of the control registers have been changed to alter event limits 
and traces. 
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■i 


^^^1 






BH 


HH 








■■■■■ 










IF GA 




3 MIC SEC 


2333024913754652 


PSW AT 


riME OF EVENT 471000000004043E INSTrT 


l23aK780B3CE 




C00040*3C) TO 






GPR 0-T 


OOOOOCOO 0OD2FO00 


00000030 


00000000 


00000000 


OOOOOOBE 


00000010 


00000002 












GPR 8-F 


00000001 0O0OOB33 


OOOOOOOF 


4004007A 


0004107A 


07C8C1E2 


B004O426 


000422F8 




/ 








CTL 0-7 


004000FF 0OOOE64O 


FFFFFFFF 


FFFFFFFF 


00000000 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 












CTL 8-F 
LOM CORE 


OOOOFFFF DQ001F80 


000404 3C 


000404EA 


00000000 


OOOOOOOO 


C2000000 


00000200 










00000000 


00000000 00000000 


00000000 


00000000 


00000000 


000Q04A0 


470F2000 


0000090C 












00000020 


47103000 0004043A 


47100000 


0004043E 


oooooooo 


000 38 174 


471DO0OO 


0004044A 


/)/^Aj^/'^£,y 


V) PfiqerAQ 








000000*0 


00000000 04000000 


10003B70 


00000000 


OOB6Z900 


02FDB4D4 


440C0000 


OOOO0C14 










00000060 


440C0000 OOOOOBCC 


OOOCOOOO 


0003BOOO 


04080000 


0000013A 


440C0000 


OOOOOBIO 


<m. ^rj-e/tt/uf 


//■ c^ f /f 








00000080 


00000540 00000080 


0002000A 


00020080 


12042003 


00025000 


0004043C 


00000 ICC 








OOOOOOAO 


jea- t/ 00000 


20000060 


0O0002C0 


OOOOOOOO 


00000100 


00000009 


OOOOOOOO 








OOOOOOCO 


00000000 


OQOOtlOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOCO 


C^4 *n aenjtf 


»y/^^«<^, s) 








SEGM table/' 0000E640 














f^"^ 








0000E6*Q 


;FOOaE3301 F000E370 
Fo60E530l£OOOE570 


F000E3B0 


F00QE3F0 


F00OE43O 


F0O0E470 


F000E480 


F000E4FO 1 
00000001 / 

00300038 "^ 
O0BO00B8 


S^Mna-Mxt 


UU.O.U.O.UO 








0OOOE660 
PAGE TABL 
0000E32O 
0000E3<^0 


FOO0E5B0 


FOOOe5F0 


00000001 
tp5o§)008 


00000001 
00100018 


00000001 

00200028 
00A000A8 






ES 0OOOE33O~ ~ 




^-^ 








00400048 00500058 


00600068 


00700078/ 


. ...&...-.. 














0O00E36O 


00C000C8 00000008 


OOE0OOE8 


00F000F8'' 


-/°«*e. 100118 


01200128 


01300138 


...H...Q...Y.0.8.. 










O000E38O 


01400148 01500158 


01600168 


80118011 


7^ 


118011 


80118011 


80118011 


. ...&...-.. 










0OOOE3A0 


80118011 80118011 


80118021 


80218021 


80218021 


80318031 


80318031 


80318041 












00O0E3C0 


80418041 80418041 


80418041 


80518051 


80518051 


80518051 


80518001 


B0018001 












0000E3E0 


80018001 80018001 


80018001 


80018001 


eMlBOOl 
86018001 


80018001 


80018001 


80018001 












O000E*OO 


80018001 80018001 


8OO18001 


80018001 


80018001 


80018001 


03810389 












0000E420 


03C103C9 03D10309 


03E103E9 


03F103F9 


01790171 


01A10199 


01890015 


00150015 


. A. I. J. R.. .2.1. 9.. 










00OOE*40 


00150015 00150015 


00150015 


00150015 


00150015 


00150015 


00150015 


00150015 \ 


y/'a^lcM 










OOOOE^AO 


— SAME— 
00150015 00150015 


00150015 


00150015 


00150015 


00250025 


00250025 


00250025 










0O0OE4CO 
OOOOE500 


00250025 00250025 
— SAME-- 
00250025 00350035 


0025002 5 
00350035 


00250025 
00350035 


00250025 
00350035 


00250025 
00350035 


00250025 
00350035 


00250025 
00350035 






( 








OOOOE520 


00350035 00350035 


00350035 


00350035 


00350035 


00350035 


00350035 


00350035 








3^ 


0000E5*0 


00350035 00350035 


00350035 


00350035 


00350035 


00450045 


00450045 


00450045 










aw 


0000E560 


00450045 00450045 
— SAME — 
00450045 00450045 


00450045 


00450045 


00450045 


00450045 


00450045 


00450045 












0OOOE5A0 


0045004S 


00450045 


0045O045 


00450045 


00550055 


00550055 












0000E5C0 


00550055 00550055 


P* 


-50055 


00550055 


00550055 


00550055 


00550055 , 














— SAME— 























0000E620 00550055 00550055 
PAGEFR TAB 0000DE88 


i50O55 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO 


OOOOOOOO / 
















0000DE80 
OOOOOEAO 




"obbjoooo 

00020000 


oVoogqbfl.! 

00040000 


00020000 
00020000 


00010000 
00050000 


00020000 
00020000 


00020000 ^ 
00060000 












00020000 00030000 












OOOODECO 


00020000 00070000 


00020000 


00080000 


00020000 


00090000 


00020000 


OOOAOOOO 












OOOOOEEO 


00020000 OOOBOOOO 


00020000 


OOOCOOOO 


00020000 


OOOOOOOO 


00020000 


OOOEOOOO 












OOOODFOO 


00020000 OOOPOOOO 


00020000 


00100000 


00020000 


00110000 


00020000 


00120000 












OO00OF2O 


00020000 00130000 


00020000 


00140000 


00020000 


00150000 


00020000 


00160000 












O0O0OF40 


00020000 00170000 


00020000 


00180000 


00020000 


00190000 


00020000 


OOIAOOOO 












0OO0DF60 


00020000 OOIBOOOO 


00020000 


OOICOOOO 


00020000 


OOIDOOOO 


00020000 


OOIEOOOO 












00000F80 


00020000 OOIFOOOO 


00020000 


00200000 


00020000 


00210000 


00020000 


00220000 












OOOOOFAO 


00020000 00230000 


00020000 


00240000 


00020000 


00250000 


00020000 


00260000 












OOOOOFCO 


00020000 00270000 


00020000 


00280000 


ooozoooo 


00290000 


00020000 


OOZAOOOO 












OOOOOFEO 


00020000 O02B000O 


00020000 


002C0000 


00020000 


00200000 


OOOOOIAO 


00810410 












OOOOEOOO 


00000418 00800188 


OOOOOIAB 


FFFF0190 


00000178 


00840418 


00OOO180 


FFFFO400 


• ..•.. 










0O00E020 


00000410 O08301A0 


00000198 


00820170 


00000 IBO 


FFFFOIBO 


O000O1B8 


FFFF01A8 


V 










OOOOE040 


OOOOOICO FFFFOIBO 


000001C8 


FFFF01B8 


OOOOOIDO 


FFFFOICO 


00000108 


FFFF01C8 


(. 


g..'.H 








0000E060 


OOOOOIEO FFFFOIDO 


000001E8 


FFFF0108 


OOOOQIFO 


FFFFOIEO 


000001F8 


FFFF01E8 


8...Y 








OOOOE080 


00000200 FFFFOIFO 


00000208 


FFFF01F8 


00000210 


FFFF0200 


00000218 


FFFF0208 










OOOOEOAO 


00000220 FFFFOZIO 


00000228 


FFFF0218 


00000230 


FFFF0220 


00000238 


FFFF0228 












OOOOEOCO 


00000240 FFFF0230 


00000248 


FFFF0238 


00000250 


FFFF0240 


00000258 


FFFF0248 





.& 








OOOOEOEO 


00000260 FFFF0250 


00000268 


FFFF025e 


00000270 


FFFF0260 


00000278 


FFFF0268 


.......s 










OOOOEIOO 


00000280 FFFF027O 


00000288 


FFFF0278 


00000290 


FFFFO280 


00000298 


FPFF0288 












00OOE12O 


OO0O02A0 FFFF0290 


000002A8 


FFFF0298 


000002BO 


FFFF02A0 


000002B8 


FFFF02A8 












O000E140 


000002CO FFFF0260 


000002C8 


FFFF02B8 


00000200 


FFFF02CO 


00000208 


FFFF02C8 


H 


Q...H 








O000E160 


000002EO FFFF0200 


000002E8 


FFFF02D8 


000002 FO 


FFFFO2E0 


000002 F8 


FFFF02E8 


V...Q.. 


.0 S...Y 








0000E180 


00000300 FFFFO2F0 


00000308 


FFFF02F8 


00000310 


FFFF0300 


00000318 


FFFF0308 


8.. 










OOOOEIAO 


00000320 FFFF0310 


00000328 


FFFF0318 


00000330 


FFFF0320 


00000338 


FFFF0328 












OOOOEICO 


00000340 FFFF0330 


00000348 


FFFF0338 


00000350 


FFFF0340 


00000358 


FFFF0348 




.S 








OOOOEIEO 


00000360 FFFF0350 


00000368 


FFFF0358 


00000370 


FFFF0360 


00000378 


FFFF0368 


...-...&... 










00OOE200 


00000380 FFFF0370 


00000388 


FFFF0378 


00000390 


FFFF0380 


00000398 


FFFFOSas 












0OOOE220 


000003A0 FFFF0390 


000003A8 


FFFF0398 


00000400 


FFFF03A0 


000303B8 


007603 A8 












OOOOE2'^0 


000303CO O07703A8 


000303C8 


007803A8 


00030300 


007903A8 


00030400 


007AO3A8 
00TE03F8 J 


H 










OOOOE260 


00030190 O07B03E0 


00030190 


007C03E8 


00030190 


007D0188 


00030198 


v.. 


* C^jC-ioHT) 






■1 


HHl 






HHI 


HH 








■mi 







An example of dumping the page tables and low address storage on an event. 







Serviceability Aids 2. 1 07 



Trace Routioes 

SDAIDS 



/ > 






EVENT AOM OR PAGE ADDR 
NC-CLASS +COOE 
EVENT-ID PS« 

TE 050000 471020000X)0410EE 
TE 04F800 471020000004 lOEE 
TE O4F000 471D2000000410EE 
TE O4ES00 47102000000410EE 
TE 04E000 471D2000000410EE 
TE 040800 471D2000000410EE 
TE 040000 47 1020000004 144C 
TE 060800 471D2000000422C8 
TE 042800 471D1000000406EA 



TOD DEC MIC SEC 
2333039363651268 
2333039363711212 
2333039363794504 
2333039363852338 
2333039363912247 
2333039363969936 
2333039364088211 
2333039407337972 
2333039407342990 



EVENT MASKING 
PER LIMITS 

E GPRS LOWER UPPER 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 



r 



GPR 13 
000402EO 
000402EO 
000402E0 
000402E0 
000402EO 
000402EO 
000402EO 
F6041E28 
F0040D78 



GPR 14 
8004 108C 
8004 108C 
8004108C 
8004108C 
8004108C 
8004108C 
80041414 
800405A6 
A004112E 



GPR 15 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
900417EC 
80041 14C 



EVENT PGM CHK INTERRUPT TOO NICSEC 

GPR 0-7 000000 IB 00040910 00000021 

GPR 8-F 00000000 00000000 00000000 

CTL 0-7 004000FF OO0OE640 FFFFFFFF 

CTL 8-F OOOOFFFF 00000000 00000000 
LOH CORE 

00000000 00000000 oooooooo pooooooo 

00000020 47100000 0004220C 147103000 

00000040 1000E718 08000000 1000E710 



00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



000004AO 
000004CO 
000004EO 
00000500 
00000520 
00000540 
00000560 
00000580 
000005A0 



440COOOO OOOOOBCC OOOCOOOO 
00000540 OOOOOOOO 00020007 
OOOOOOOO OOOOOOOO 20000060 
OOOOOOOO OOOOOOOO OOOOOOOO 
— SAME — 

SUPERVISOR 

00000120 OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
— SAME — 

FIF261F0 F661F7F3 70007000 OOOOOOOO 
00060FFF 0004232F 0004232F 00000010 
41044296 42974389 3F003F06 3F0C38F1 
46300000 3DCC3E4C 3E8C0010 OOOOOOOO 
OOOOOOOO 04A010E0 00000588 C0C0034O 
00006140 00002ECA 080407CO OO004I34 
00017000 08005DE6 0032002C 00050000 
60800800 000008FC 00009260 00005F78 
OOOOOOOO 00007998 00006360 00003854 



2333039515946093 PSW AT TIME OF EVENT 47103000000^ 
00000002 0000002E OOOOOOOO OOOOOOOO OOOOOOOO 
4004007A 0004107A 07C8C1E2 A00406EE 000422A0 
FFFFFFFF OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOFFFFFF OOOOOOOO O0OOB0O& C2000000 00006200 

OOOOOOOO/ToOOOOOOr 000004AO 40000000 OOOOOOOO 
00040718) OOOOOOOO 0003E974 470C2000 0000090C 
OOOOOOOO FC4F0500 023E32CD 44OCO000 OOOO0C14 
0003E800 04080000 OOO0D13A 440COOOO OOOOOBIO 
OdoiSbOOT 12042003 00020000 OOOOOOOO OOOOOICC 
000002C(N OOOOOOOO 00000100 OOOOOOOE OOOOOOOO 
OOOOOOOO \00000000 OOOOOOOO OOOOOOOO OOOOOOOO 



GPR GPR 1 GPRZ 
00000002 OOOOE003 00041D2A 
00000002 O0O0E50A 00041E84 
00000002 00000006 0004IF04 
00000002 00OOD5O6 00042138 
00000002 OOOOC004 00042250 
00000002 OO0OC502 0004235C 
00000002 0000B051 000424SE 
00000080 00040BIA 000403F4 
00040078 00040B1A OOOOOOOI 

INSTR (g|jb3C676C5EC 

-* 6 



i^oy/z 



:x:H'UtiKiAin y^t^f-uTZciSf^ 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 

OOOOOOOO OOOOOOOO C2E4C707 D9C7C3D2 12/06/73 BUGPRGCK 

OOOBFFFF F07FCED3 30A0CED0 002E40FD L 

F2F0F6F7 F3F3F4F0 00003CD4 0000003C 120673340. ..M.... 

00008090 00007118 00003864 3BD45A30 M. . 

40404040 40404000 40404040 40404000 . . 

000026C4 00004888 00005854 000082E8 ../ V 

0000700C OOOOOOOO 00008299 000060B8 U .-. 

00006068 000060C0 OOOOdtflO 00007480 - -......-...- 

00000638 00008099 OO004246 00000760 ..- - ^. 



An example showing the output to device X'OOE' (a line printer) after specifying 
a "dump on program check" and a page translation exception trace using output 
class FASTREC, AUTOMATIC 

Notice that the SD buffer is dumped before the dump of the supervisor and real 
storage. (A system dump would follow the SDAID dump if it was requested; refer to 
A-2 in this Section for a description of the system dump.) 



V.^> 



BHIF 
GP* 0-7 
GPU 8-F I 
CTL 0-7 
CTL 8-F 
L3W CORE 
OOOOOOOO 
00000020 
00000040 
00000060 
00000080 
OOOOOOAO 
OOOOOOCO 



..-» r00O4O0C6> TOO MICSEC 
00(jSi003 000404E8 00003FEO 
80041088 00041084 40041032 






2327688745012422 

0Q04a7Al 00003004 OOOOOOOI 00000006 
00040088 00041888 00042888 000004AO 
FFFFFFFF 00030000 OOOOOOOO OOOOOOOO 
00040660 OOOOOOOO OOOOOOOO C2000000 



PSW 470D000000040E78 I NSTR ^FOBOFg^TFO 
80041800 
00000540 
OOOOOOOO 
00000200 



CoijU. 



00008CA0 OCOOOOOO 00003860 
440:0000 OOO0OC4E OOOCOOOO 
00333540 00000080 00020040 
OOOOOOOO OOOOOOOO 2 0000060 
00030000 OOOOOOOO OOOOOOOO 
— SAME— 
COHREG LOC 000004AO 
000004AO F1F061FO F561F7F3 70007000 
000004CO O0088FFF 00042D1B OOOOOOOO 
000004EO 3F3841A6 41A74299 3DD03DD6 
00000500 45400000 3B9C3C1C 3C8C0010 
00000520 60000000 04A010E0 00000588 
00000540 0O0663E8 00002BFE 083607F0 
00000560 00017000 0700608E 0032002C 
SVSCOM LOC 00000540 
00000540 000063E8 00002BFE 083607FO 
00000560 00017000 07OO6O8E 0O32002C 
00000580 60800840 00000952 00009488 
C00005AO 0000053C 00007040 00006608 
000005CO 00003156 O0O0A264 000006E4 
000 005 EO 00081018 00200000 OOOOOOOO 
00000600 OOOOOOOO OOOOOOOO OOOOOOOC 
00000620 00006680 OOOOOOOO 00002972 
00000640 OOOOOOOO OOOOOOOO 00003CDO 



OOOOOOOO 
00043E78 
OOOOOOOO 
0003 BOOO 
00040380 
000O02C0 
OOOOOOOO 



OOOOOOOO 
00303010 
30DC33F1 
00003300 
COC00740 
00004000 
00050000 

00004000 
00053000 
00006220 
00003594 
OOOOOOOO 
OOOOOOOO 
01710001 
0003FFFF 
00003SC6 



OOOOOOOO 
00003000 
FD083E00 
04080000 
12042803 
OOOOOOOO 
OOOOOOOO 



OOOOOOOO 
OOOFFFFF 
F0F0F5F7 
00008480 
404040 40 
00009AOO 
000072 B4 

O0O09A0a 
000072 B4 
00006310 
OOOOOS60 
00000960 
OOOOOOOO 
00O0F60O 
000086C8 
OOOOOOOO 



000004AO 
00000300 
02583606 
O003B188 
0002C000 
00000100 
OOOOOOOO 



OOOOOOOO 
FD7FFED3 
F3F2F7F8 
000674B8 
40404000 
00004798 
OOOOOOOO 

00004798 
OOOOOOOO 
00006368 
000084C5 
00009088 
000036 72 
0000ED38 
A00E8000 
OOOOOOOO 



471D1000 
470F2000 
44 OC 0000 
440C0000 
000400C6 
00000130 
OOOOOOOO 



D2C50561 
3000FEDO 
00003AA4 
00003SA4 
40404040 
0000 5 AF8 
0000876A 

00005AF8 
0303876A 
00000010 
0000414A 
00003838 
OOOOOOOO 
O0OOF160 
OOOEFOOO 
000006BO 



000 4047 A 
00300962 
O00O0CC8 
000 OB 92 
000 001:; 8 
OOOOOOOO 
OOOOOOOO 



E3D6D4E2 
0aC63FDl 
0000003C 
39A45C04 
40404000 
000087C0 
00306360 

000087C0 
00006360 
00007850 
00000790 
OOOOOOOO 
OOOOOOOO 
00006620 
OOOOOOOO 
07241054 









eyetiA^ BR a^c/ /f. 



10/05/73. 

iQiir.'.'.'. 


lol! 


.100573< 
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• 
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An example of dumping the active communication region and low address 
storage on an event. 



2. 1 08 Serviceability Aids 



o 



Trace Routines 

SDAIDS 



^Kyjglflr 













HHI 




■ 




^ // JOB 0EBUG6X1 

• // OPTION NODECK.LIST, 
// EXEC ASSEMBLY 

• PAGENQ PAGE 00040800 


XREFiLINK.LOGfOUHP 

KEY 1 TASKID 1 


REQUID 03 


DATE 12/06/73, CLOCK 11/49/33 
"• "^ _— Jl' A- ,-- J^ 


1 




_ PA6EH0L 


PAGE 00040800 


FRAME 00018800 KEY 1 TaSKID 1 


REQUIO 03 


TFIX 


//TZft/tUe!tyU>if^ Cx-cMM-a-n 


H 




PAGENQ 


PAGE 00041000 


KEY 1 TASKID I 


REQUID 03 


TFIX 




■ 




• PAGEHDL 


PAGE 00041000 


FRAME 00019000 KEY 1 TASKID 1 


REQUID 03 


TFIX 


H 




^ PAGENO 


PAGE 00041800 


KEY 1 TASKID 1 


REQUIO 03 


TFIX 


H 




PAGEHOL 


PAGE 00041800 


FRAME 00019800 KEY 1 TASKID 1 


REQUIO 03 


TFIX 




H 




• PAGENO 


PAGE 00042000 


KEY 1 TASKID 1 


REQUIO 03 


TFIX 




H 




^ PAGEHOL 


PAGE 00042000 


FRAME OOOIAOOO KEY 1 TASKID 1 


REQUIO 03 


TFIX 




H 




PAGENQ 


PAGE 00042800 


KEY 1 TASKID 1 


REQUID 03 


TFIX 




H 




• PAGEHOL 


PAGE 00042800 


FRAME 00018000 KEY I TASKID 1 


REQUID 03 


TFIX 




H 




^ PAGENQ 


PAGE 00043000 


KEY I TASKIO 1 


REQUIO 03 


TFIX 




H 




PAGEHOL 


PAGE 00043000 


FRAME 00017800 KEY 1 TASKIO 1 


REQUIO 03 


TFIX 




H 




• PAGENQ 


PAGE 00043800 


KEY 1 TASKID 1 


REQUID 03 


TFIX 




H 




W PAGEHDL 


PAGE 00043800 


FRAME 0001A800 KEY 1 TASKID 1 


REQUIO 03 


TFIX 




H 




PAGENO 


PAGE 00044000 


KEY 1 TASKID 1 


REQUID 03 


TFIX 




H 




• PAGEHDL 


PAGE 00044000 


FRAME OOOIBOOO KEY 1 TASKIO 1 


REQUIO 03 


TFIX 




H 




^ TE PAGE 


ADDR 0005DOOO 


TOD MICSEC 2333011788410151 


PSW AT TIME OF EVENT 


4710200000041632 INSTR 92FF2002943F 


H 




PAGENQ 


PAGE 0005D000 


KEY 1 TASKID 1 


REQUID 10 


TE 




H 




• PAGEHDL 


PAGE 00050000 


FRAME 00018800 KEY 1 TASKID 1 


REQUID 10 


TE 




H 




^ TE PAGE 


AODR O0O5FO0O 


TOO MICSEC 23330117886|tl54 


PSW AT TIME OF EVENT 


471000000004166E INSTR OT06AOOOA0O0 


H 




PAGENO 


PAGE 0005F000 


KEY 1 TASKIO 1 


REQUIO 10 


TE 




H 




• PAGEHOL 


PAGE OOOSFOOO 


FRAME OOOICOOO KEY 1 TASKIO 1 


REQUID 10 


TE 




H 




^ TE PAGE 


ADOR 0005F800 


TOD MICSEC 2333011790227387 


PSW AT TIME OF EVENT 


4710300000040644 INSTR OEE005010686 


H 




PAGENQ 


PAGE 0005F800 


KEY 1 TASKIO 1 


REQUIO 10 


TE 




H 




• PAGEHOL 


PAGE 0005F800 


FRAME 0001C800 KEY I TASKID 1 


REQUID 10 


TE 




H 




_ TE PAGE 


ADOR 00060000 


TDD MICSEC 2333011793770641 


PSW AT TIME OF EVENT 


4710300000040644 INSTR OEEOD501D686 


H 




PAGENQ 


PAGE 00060000 


KEY 1 TASKID 1 


REQUID 10 


TE 




H 




• PAGEHDL 


PAGE 00060000 


FRAME 00010000 KEY 1 TASKID 1 


REQUIO 10 


TE 




H 




^ TE PAGE 


ADDR 00060800 


TOO MICSEC 2333011796139258 


PSW AT TIME OF EVENT 


4710300000040644 INSTR 0EE00501D686 


H 




PAGENQ 


PAGE 00060800 


KEY 1 TASKIO 1 


REQUIO 10 


TE 




H 




• I^AGEHOL 


PAGE 00060800 


FRAME 0001D800 KEY 1 TASKIO 1 


REQUID 10 


TE 


Cei'Zf/fr) 


1 












IHH 




1 



An example of SDAID page tracing during an assembly job. 



o 



EVENT ADOR OR PAGE ADOR 
NC-CLASS «COOE 
EVENT-IO PSW 

TE 043000 470D000000041C6Z 
TE OSOOOO 471D200000041632 
TE OSFOOO 471D00000004166E 
TE 05F800 4710300000040644 
TE 060000 4710300000040644 
TE 060800 471D300d00040644 
TE OS9800 4710200000041E2C 
TE 057800 4710200000041E6E 
TE 0SB800 4710300000040644 
TE OSCOOO 4710300000040644 
TE OSC800 4T1D300000040644 
TE OS0800 4T1D2000000410EE 
TE 050000 471D2000000410EE 
TE 04F800 47102000000410EE 
TE 04FOOO 47102000000410EE 
TE 04E800 471DZ000000410EE 
TE 04EOOO 471D2000000410EE 
TE 040800 471020000004 lOEE 
TE 040000 471 020000004 144C 
TE 060800 4710200000042208 
TE 042800 47101000000406EA 
TE 043000 4700000000041C62 
SOBUFFER END 



TOD DEC MICSEC 
2333035396598690 
2333035416187226 
2333035416192369 
2333035417576315 
2333035420950387 
2333035423146414 
2333035449944730 
2333035449949477 
2333035453007449 
2333035453671223 
2333035454009747 
2333035623279245 
2333035623336942 
2333035623396991 
2333035623480401 
2333035623538305 
2333035623598321 
2333035623656083 
2333035623774539 
2333035667085247 
2333035667090270 
2333035783718692 



EVENT MASKING 
PER LIMITS 

E GPRS LOWER UPPER 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFPF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 

0000 000000 FFFFFF 



GPR 13 
00042888 
000402EO 
000402E0 
000402EO 
000402EO 
000402EO 
00040 2 EO 
000402EO 
000402E0 
000402E0 
000402EO 
000402E0 
000402EO 
000402EO 
000402EO 
000402EO 
000402E0 
000402E0 
000402 EO 
F6041E28 
F0040D78 
00042888 



GPR 14 
000004AO 
0004 14F8 
80041646 
0005F7FO 
0005FFEA 
O006O7F4 
00040F58 
00040FS8 
0005B7EE 
0005eFF6 
0005C7CA 
8004108C 
8004 108C 
8004 108C 
8004 108C 
8004 108C 
8004 lose 
8004108C 
80041414 
80040SA6 
A004112E 
0OOO04AO 



GPR 15 
00000760 
00060FFE 
0005F25S 
00000019 
OOOOOOIF 
0000003F 
0005F255 
0005F255 
00000039 
00000021 
00000046 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041AF4 
00041 AF4 
00041AF4 
00041 AF4 
900417EG 
80041 14C 
00000760 



GPR 
00000003 
80041934 
80041934 
0005F255 
0005F255 
0005F25S 
00040A7C 
00040A7C 
00050447 
00050447 
0005D447 
00000002 
00000002 
00000002 
00000002 
00000002 
00000002 
00000002 
00000002 
00000080 
00040078 
00000003 



GPR I 
00003FOC 
00040C2S! 
00040C20 
00000019 
OOOOOOIF 
0000003F 
00059841 
00001C7E 
00000039 
00000021 
00000046 
OO0OFSO4 
OdOOE003 
O00OE5OA 
00000006 
00000506 
OOOOC004 
0000C502 
OOOOBOSl 
00040B1A 
00040B1A 
00003F0C 



6PR2 

OQ00410C 

0005D9DT 

00040A7F 

00040B39 

00040B3F 

0005F289 

0000 1C7E 

00059B32 

00000004 

00000005 

00000005 

00041BD4 

00041D2A 

0004 IE B4 

00041FD4 

00042138 

00042250 

0004235C 

0004245E 

000403F4 

00000001 

0000410C 



(exz^iv^l 



A dump of the SD buffer after executing a page trace (TE) using the FASTREC 
output class. (The SD buffer is dumped on termination of SDAID). 



Serviceability Aids 2.109 



Trace Routines 

SDAIDS 









■ 




■ 


■ 


HI 


■ 


Hi 


HHHH 






■■■■ 






_ IF GA 


00040* 3C 


TOD 


iwCSEC 2333012672382809 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


123347808 3CE 






BR IF 


000*043E 


TOO 


MlVsEC 2333012672458551 


PSW 


AT 


TIME 


OF 


EVENT 


471D000000040448 


INSTR 


478083CE0630 








• IF 0* 


00040448 


TOD 


MIcVeC 2333012672534442 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004044A 


INSTR 


124447a0B3DA 








— BRIF 


0004044A^ 


TOO 


MICs\c 2333012672610919 


PSM 


AT 


TIME 


OF 


EVENT 


471D000000040454 


INSTR 


4780B3DA0640 








IF G* 


00040454 


V TOD 


MICSE\ 2333012672685341 


PSW 


AT 


TIME 


OF 


EVENT 


471D200000040456 


INSTR 


125547808 3E6 








• IF 


00040456 


Vju 


MICStcX 2333017672761969 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004 045A 


INSTR 


4780B3E60650 








_ IF GA 


0004045A 


'\ 


llCStC Y2333O126728JB460 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047FOB3C2 








BRIF 


0004045C 


TOO* 


UlCStC 1333012672913531 


PSW 


AT 


TIME 


OF 


EVENT 


471U20000004043C 


INSTR 


47F0B3C21266 








• IF GA 


000404 3C 


TOD 


l\cSEC 2\33012672990157 


PSW 


AT 


TIME 


OF 


EVENT 


47IU00000004043E 


INSTR 


12334780B3CE 








_ BR I F 


C004043E 


TOO 


Mlfl^EC 2313012673065877 


PSM 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 








IF GA 
• BRIF 
^ IF GA 


00040448 

0004044a)s, 

0-1040454 


TOO 

TDD 


MIC«C 233B012673140296 
MICSeX 233\ol?6732I692l 
MI C SEC \ 2 ) 3 3B 1 2673293403 


PSW 
PSW 
PSW 


AT 
AT 
AT 


TIME 
TIME 
TIME 


OF 
OF 
OF 


EVENT 
EVENT 
EVENT 


471000000004044A 
4710000000040454 
471D200000040456 


INSTR 
INSTR 
INSTR 


12444780b3UA 


BZ cue/tti s 
ltR S.S 




[47806 30*10640 


|12S5|4780B3E6 




IF 


00040456 


TOO 


mH^EC \333ll2673368510 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


I4780B3E«|0650 


0Z CL£/lft.& 






• IF GA 
_ BRIF 


0004045A 
0004045C 


TOD 

TOO 


MlCSa^ 2\330y2673445''86 
Ml \ \ 1 "* 


PSw 
PSW 


AT 
AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


4710200000040450 
4710200000040430 


INSTR 
INSTR 


I065C|47F0B3C2 






47F0B3C2|1266 




IF GA 
* HRIF 


rO0404 3C 
0004043E 


TOO 
TOO 


Ml - » V ' }«l 


PSW 

PSW 


AT 

AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


4711J0000000404 3E 
4710000000040448 


INSTR 
INSTR 


|1233|4780B3CE 


LTR -3,3 
SZ CiSfidf 




|4780H3C^630 




_ IF GA 


r0040448 

> 


^Xfni) 


MI / 19 


PSW 


AT 


TIME 


OF 


EVENT 


47U)00000004044A 


INSTR 


(1244^780B3DA 


KTfi i4-,q. 






BRIF 


C004044A J 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


4 710000000040454 


INSTR 


|4780B30a|0 640 


e>z c i-dw/e 5 






• IF GA 


_ —^ 

00040454 


TOO 


"ti .i^At^ aJJf^M n 


PSW 


AT 


TIME 


OF 


EVENT 


4710200000040456 


INSTR 


12554780B3E6 






_ IF 


03i?40456 


T')0 


MI S2 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045A 


INSTR 


4780B3E60650 








IF GA 


0004045A 


TOD 


Ml 31 


PSW 


AT 


TIME 


OF 


EVENT 


471(J20000004045C 


INSTR 


O65O47F0B3C2 








• BRIF 


00040450 


TOD 


PSW 


AT 


TIME 


OF 


EVENT 


47ID20000004043C 


INSTR 


47F0B3C21266 








_ IF GA 


0'~0404 3C 


TDD 


PSw 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 








BRIF 


'''104043F 


J 


MI_, 96 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


JNSTR 


4780B3CE0630 








• IF GA 


00040448 


J^ 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004044A 


INSTR 


12444780B3DA 








^ BR I F 


0004044 a) 


TOO 


MICSEC 2333012674430955 


PSw 


AT 


TIME 


OF 


EVENT 


471D000000040454 


INSTR 


4780B3DA064S 










IF 


00040454 


TOO 


MICSEC 2333012879517750 


PSW 


AT 


TIME 


OF 


EVENT 


471D200000040456 


INSTR 


12554780B3E6 










• IF 


rO04O456 


TOO 


MICSEC 2333012879592055 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004045A 


INSTR 


4780B3E60650 










• IF 


000404SA 


TOO 


MICSEC 2333012879663631 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047F0H3C2 










BRIF 


0004045C 


TOD 


M|r<;fr ?1H01 7R797451 85 
M ^C^l^^ ^/-/^ ,57 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004043C 


INSTR 


47FOB3021266 










• IF 


0004043C 


TOD 


PSW 


AT 


TIME 


OF 


EVENT 


471000000004043E 


INSTR 


12334780B3CE 










^ BRIF 


0004043E 


TOO 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 


/5 a: 1^ 






IF 

• BRIF 


00040448 
0004044a) 


TOD 
TOD 




PSW 
PSW 


AT 
AT 


TIME 
TIME 


OF 
OF 


EVENT 
EVENT 


471P00000004044A 
471D000000040454 


INSTR 
INSTR 


12444780B3DA 
4780B3DA0640 








• IF 


00040454 


TOD 


PSW 


AT 


TIME 


OF 


EVENT 


471D200000040456 


INSTR 


12554780B3E6 










IF 


00040456 


TOO 


" /«^«*^^ '" 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004045A 


INSTR 


4780B3E60650 










• IF 


0004045A 


TOO 


" -fccc^r "*'> 


PSW 


AT 


TIME 


OF 


EVENT 


471020000004045C 


INSTR 


065047FOB3C2 










^ BRIF 


0004045C 


TOO 


MlCitU -^131012880351883 


PSW 


AT 


TIME 


OF 


EVENT 


471D20000004043C 


INSTR 


47F0B3C21265 










IF 


000404 3C 


TOD 


MICSEC 2333012880427507 


PSW 


AT 


TIME 


OF 


EVENT 


471D00000004043E 


INSTR 


123J4780B3CE 










• BRIF 


0OC4043E 


TOO 


MICSEC 2333012880501878 


PSW 


AT 


TIME 


OF 


EVENT 


4710000000040448 


INSTR 


4780B3CE0630 




' (ISxJi ht) 










■ 




■ 


■ 


■ 


■ 


Hi 


HHHI 


■ 




HHI 








This example shows an SDAID BR, IF and GA trace used to trace a loop using 
output class PSW. 

The GA trace was "taken off" by changing the contents of control register 9, and the 
programmers remarks on this example show how the information is interpreted. 






> 
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Library Display Programs and Utilities 

LSERV 



For the 2314/2319, 3330/3333^ and 3350, there is one label information 
cylinder on the first full cyHnder after the last system library on SYSRES. 
For the 3340, there is a second, adjacent label information cylinder which 
contains standard labels for all partitions. A display of all labels on the 
cylinder, with the exception of Data Set Secured labels, can be obtained 
by executing LSERV. Illustrations in this section show the location of 
the label information cylinder on SYSRES, and the layout of label 
information and record format. 






System requirements 

LSERV may be executed in any partition, with a minimum of 8192 bytes of the 
real or virtual address areas. LSERV assumes that the SYSRES label cylinder is 
formatted as described in DOS/ VS DASD Labels. 



Executing LSERV 

The control statements necessary to execute LSERV in a virtual partition are: 

From the console (SYSLOG): 

//EXEC LSERV 

From SYSRDR: 

// JOB jobname 
//EXEC LSERV 

/* 
/& 

LSERV can also be executed in a real partition. The output of LSERV shows the 
contents of the label cylinder(s) on the device assigned to SYSRES. The output is 
directed to the device assigned to SYSLST. 



\. /' 



When and How to use 

1 . Operator action given in DOS/VS Messages indicates when LSERV must be 
executed. 

Programmer action, also given in DOS/VS Messages, explains how to use the 

LSERV printout. 

For example, under the message: 

0P36I NO REC FND 

2. It is useful to execute LSERV prior to running a program that is known to have 
been run sometime in the past, but whose workfile assignments and partition 
allocations are unknown. 

3. LSERV can be used for error analysis. LSERV displays the TLBL and the DLBL 
and EXTENT information contained on the SYSRES label cylinder(s). Information 
about secured data files is not displayed. 



Summary of information provided 

The printout of LSERV will show you the following details about the previous run: 

• Whether the correct DLBL/EXTENT information is still on the label cyUnder(s) 

• The permanent files 

• The temporary files 

• Extent type 

• File type. 

An example shown at the end of this chapter relates the data printed by the LSERV 
program to the DLBL/EXTENT job control statements. 
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The Label Information Cylinder(s) 

The label information cylinder(s) contain(s) standard and user label information 
for background and foreground partitions. 

This label information is stored on 19 tracks (1 full cylinder) on the 3330/3333, 
20 tracks (1 full cylinder) on the 2314/2319, 24 tracks (2 full cylinders) on 
the 3340, or 30 tracks (1 full cylinder) on the 3350. 

The purpose of the label cylinder(s) is to enable label information to be placed in 
the label save areas during program execution. 

Job control stores label information, which is contained in the input job stream, 
on the label cylinder(s). 

During program execution, label information on the label cyUnder(s) is used by 
the OPEN and CLOSE routines. 



Library Display Programs and Utilities 

LSERV 




o 



SAMPLE JOB STREAM 

// JOB CATALOG USER PROGRAM 
// OPTION CATAL 

C Object module preceded t 
by PHASE and INCLUDE J 



User 
Phase 



1 /* 



// LBLTYP NSD (01 ) 1 

// EXEC LNKEDT ' J 

/& 

//JOB EXECUTE USER PROGRAM 

// DLBL 




// EXTENT 

//DLBL 

// EXTENT 

//TLBL 

// ASSGN 

// ASSGN 

// ASSGN 

// EXEC USER 

/& 



File 1 (Seq. Disk) 

File 2 (Nonseq. Disk) 

File 3 (Labeled Tape) 
File 1 
File 2 
Files 



Sequence of Events 



LBLTYP reserves label area in virtual storage 
for longest label block 

Link edit and catalog user phase to core 
image library 

Write label information to label cylinder(s) 

Assign user files 

Bring program into virtual storage and process 
OPEN/CLOSE 

a. Bring label storage data into virtual storage 

b. Bring file labels into virtual storage 

c. Compare input, create new output labels. 



SYSRES 



Label 

Information 

Cylinder(s) 



An overview showing how DOS/VS uses 
the label information cylinder(s). 



Supervisor 



Seq. 
Disk 



Transient Area 



Label Area 

Nonseq. Disk and Tape 



Background Partition 
USER Program 

fOpen all Sl 
Close all 3 J 



Virtual 
Storage 
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Library Display Programs and Utilities 

LSERV 



NO. 




COMPONENT 


STARTING DISK ADDRESS 


NUMBER 
OF TRACKS 
(Allocation) 


R = REQUIRED 
= OPTIONAL 




BB 


cc 


HH 


R 


1 


IPL Bootstrap Record 1 ($$A$IPL1) 


00 


00 


00 


1 


1 


R 


IPL Bootstrap Record 2 ($$A$IPL1 ) 


00 


00 


00 


2 


R 


Volume Label 


00 


00 


00 


3 


R 


User Volume Label 


00 


00 


00 


4 





2 


System 
Directory 


Record 1 


00 


00 


01 


1 


1 


R 
R 
P 
R 


Record 2 


00 


00 


01 


2 


Record 3 


00 


00 


01 


3 


Record 4 


00 


00 


01 


4 


IPL Retrieval Program ($$A$IPL2> 


00 


00 


01 


5 


R 


3 


Core Image Library Directory 


00 


00 


02 




» 


R 


4 


Core Image Library 


00 


End of CI Directory 




* 


R 


X Y+1 


5 


Relocatable Library Directory 


00 


End of CI Directory 




* 





Z+1 


00 


6 


Relocatable Library 


00 


End of RL Directory 




♦ 





X 


Y+1 


7 


Source Statement Library Directory 


00 


End of RL Directory 




* 


r^i 


Z+1 1 00 


8 


Source Statement Library 


00 


End of SS Directory 




* 





X Y+1 


9 


Procedure Library Directory 


00 


End of SS Directory 




» 





Z+1 


00 


10 


Procedure Library 


00 


End of PL Directory 




* 





X Y+1 


11 




00 


End of P Library 




* * 





Label Inf 


ormation Cylinder 


Z + 1 


00 



•Allocation Dependent On User Requirements 
X = Ending CC of the Preceding Directory 
Y = Ending HH of the Preceding Directory 
Z = Ending CC of the Preceding Library 



20 (i cylinder) for 2314/2319 
19 (1 cylinder) for 3330/3333 
24 (2 cylinders) for 3340 
30 (1 cylinder) for 3350 



The location of the label information cylinder on the SYSRES extent 



J' 
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Device Type 


Track 


Label 
Type 


For Partitions 








5 


4 


3 


2 


1 


s 

n 


05 

CO 
CN 

n 

(N 

1 


n 
m 
n 

1 


1 

> 
o 

i 

CO 


00 


USRLABEL 


BG 


BG 


BG 


BG 


BG 


01 


PARSTD 


BG 


BG 


BG 


BG 


BG 


02 


USRLABEL 


F4 


F3 


F2 


F1 


msem 


03 


PARSTD 


F4 


F3 


F2 


F1 


04 


USRLABEL 


F3 


F2 


F1 




05 


PARSTD 


F3 


F2 


F1 


06 


USRLABEL 


F2 


F1 








07 


PARSTD 


F2 


F1 




08 


USRLABEL 


F1 






09 


PARSTD 


F1 


Standard labels 
for all partitions 


10 


STDLABEL 




11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 
29 






1 

> 
u 

T> 

C 
CM 

CO 


00 
01 


STD LABEL 




Standard Labels 
for all partitions 






02 




03 
04 




05 




06 




07 




08 




09 




10 




11 
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LSERV 




CI 



Label sets submitted in a job stream 
without a // OPTION PARSTD, STDLABEL 
are written to the temporary area for the 
partition being used. 



Track allocations of the Label Information Cylinder for a 1, 2, 3, 4, and 5-partition system. 
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LSERV 



"~1^ 



Job Control Statements or Operator Initiation Commands 



//VOL 



X 



and 



> 



//TPLAB 



//TLBL 



Label 

Information 

Cylinder 














//TLBL 










\ 




//VOL 






//TPLAB 


^ 






^ "^ 


r 






"X 




f^«$erveKl 
B<m 


Filename 


IIIHIjlj 
lllliiii 


File 
ID 


File 

Serial 

Number 


Volume 

Sequence 

Number 


File 

Sequence 

Number 


Generation 
Number 


Version 
Number 


Creation 
Date 


Expiration 
Date 


liilll 

iililili 
llllllll 


Block 
Count 


iiiiill 


Flag 
Bytes 


1 


7 


1 


17 


6 


4 


4 


4 


2 


6 


6 


1 


6 


13 


2 


C 


) / 


r>; 


1 
Byte Count 


8 


9 


26 


32 


36 


40 


44 


46 


52 


58 


59 


65 


78 



Format and contents of the label information cylinder for tape labels 

(Shaded areas are not processed by DOS/VS Logical IOCS) 
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Library Display Programs and Utilities 



1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


12 


14 15 


16 


17 


18 




19 


Field 


2 

UJ 

1- 
m o 

_JT3 


Filename 


u 

♦J 

1 

< 
< 

Q 


File ID 


9 

o 

LL 


File 

Serial 

Number 


6 
z 

cr 
w 

3 


w 
Q 
c 
.2 

CO 
ID 


Si 

c 
.2 

CO 

■q. 

X 

LU 


■a 

! 


03 

■o 

a 

c 

IV 

a 
O 


System 
Code 


Volume 

Serial 

Number 


(U 

a 
> 

1- 
+j 

c 

LU 


O 

z 

cr 
a> 

CO 

<-> 

c 

UJ 


Extent 
Lower 
Limit 


Extent 
Upper 
Limit 


o 

COT3 

g< 
35 


& 

5 

cs 

CO 
CN 


1 

& 
a 

a 

o 

CM 


Another 
Extern if 
DAM. 
iSAW Of ^ 
VSAM 


1 


7 


1 


44 


1 


6 


2 


3 


3 


2 


1 


13 


6 


1 


1 


4 


4 


2 


1 


1 


Bytes 


o 


*" 


CO 


O) 


CO 

in 


S 


8 


S 


CO 


§ 


o 

r-. 


r»- 


s 


§ 


oi 


CM 
05 


CO 

o> 






CN 



CO 




Displacement 



LSERV 




F/e/rf Name 

1. DLBL-EXTE 

SAM 






10. 



12. 



o 



Description 

NT 

Bit 0: 1 = Next extent on a new pack. 
Bit 1 : 1 = Last extent. 
Bit 2: 2 = Bypass extent. 
Bit 3:1= New volume on same unit. 
Bit 4: 1 = Extent limits omitted. 
Bit 5: 1 = Extent converted to DASD 

address. 
Bit 6: 1 = No EXTENT/XTENT card. 
Bit 7: 1 = Unused. 



DAM, ISAM, 
or VSAM 

Filename 

DAM/SAM 
Switch 



Number of extents. 

Bits 0, 1 : tinused 

Bit 2: 1 = BLKSIZE was specified in the 
DLBL statement; the specified 
value is stored in Field 12, Bytes 80—83. 

Bit 3: Unused. 

File ID File identifier including generation and 

version numbers. If field is missing on 
DLBL card, Filename padded with blanks 
is inserted. 

This field is not used when a VSAM data 
space or file is defined. 

Numeric 1 is inserted. 

Volume serial number from first extent. 

Always initialized to X'0001'. 

Initialized with 3 bytes of X'OO'. 

If date is in the form YYDDD, it is converted 
to YDD. If date is in retention period form, 
1 to 4 characters, the field is padded with 
binary zeros. 

Reserved The retention period, if specified, is 

converted to a 2-bvte number and inserted 
in this field. 



5. 


Format ID 


6. 


File Serial 




Number 


7. 


Volume Seq 




No. 


8. 


Creation 




Date 


9. 


Expiration 




Date 



11. Open Code DLBL type: 

A = VSAM 

S = Sequential access method 
D = Direct Access method 
C or E = ISAM 

where: 

C = Load create function 
E = Load extend function 

System Code This field is processed by DOS/VS in only 
two cases, namely when VSAM is used or 
when the BLKSIZE parameter of the DLBL 
statement is used. In these cases, the field 
has the following formats: 



NOTE: For SAM files, a complete 104-byte block is repeated for 

each new EXTENT. 

For DAM, VSAM, and ISAM files, only fields 13 through 

18 are repeated for each EXTENT. 
Format and contents of the label information cylinder for DASD and DISKETTE labels 



Field Name Description 

For VSAM: 
Bytes 

71—77 Filename of owning catalog, as 

in DLBL CAT 
78-79 Not used by DOS/VS 
80—83 Buffer space (virtual) for this 

file, as in DLBL BUFSP 

For BLKSIZE: 
Bytes 

71-79 Not used by DOS/VS 
80—83 The blocksize (in binary) taken 
from the DLBL statement. 

13. Volume Serial 

Number Volume serial number for extent. 

14. Extent Type Same codes as in Format-1 label: 

X'OO' = Next three fields do not indicate 
any extent. 

X'01 ' = Prime data area ISAM, data area 
(SAM, DAM), or data space 
(VSAM) (that is the extent 
containing the user's data records). 

X'02' = Overflow area of an ISAM file. 

X'04' = User label track area. 

X'Sn' = Shared cylinder indicator, where 
n = 1, 2, or 4. 



15. 



16. 
17. 



Extent Seq. 
No. 



Number of extent as determined by the 
extent card sequence. 



18. 



19. 



Extent Lower 

and Upper Before the OPEN, DLBL/EXTENT 

Limits information is in the relative track form of 

HHNNT followed by three bytes of binary 

zeros. 

HH = Relative (to 0) start address in tracks. 
NN = Number of tracks. 
T = or upper track number for split 
cylinder in SAM files. 

Following an OPEN on DLBL/EXTENT 
cards, or whenever DLAB/XTENT cards 
are used, the extent lower and upper limits 
are each in the CCHH format. 

Logical (Symbolic) 

Unit Address 

This 2-byte field identifies the logical unit 
with the same code as that used in a CCB. 
The first byte identifies the unit class: 

X'OO' = System Logical Unit 
X'01' = Programmer Logical Unit 

The second byte identifies the logical unit 
within its class. 

Thus, X'0003' denotes SYSLST and 
X'01 03' denotes SYS003. 

2321 Lower Cell 

2321 extent lower and upper cell limit. 
2321 Upper Cell 

This 2-byte field contains zeros for 

disk storage devices. 
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c 




An example of some of the output to a line printer after executing the LSERV program, part 1 



/ 
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Library Display Programs and Utilities 

LSERV 



EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TVPE 

EXTENT LIMITS OMITTED 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 












00 

I (PRIME DATA) 

SYSRDR CCB FORMAT 0000 
OMITTED 




Ft USER LAdELS (TEMPORARY PER PARTITIONI 


TRACK 


8 








NONE 
















Fl PARTITION STANDARD LABELS (PERMANENT) 


TRACK 


9 








IJSYSIN 

FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
RETENTION PERIOD (OAYSI 
FILE TYPE 












SYSRDRIO 

OMITTED 

01 

OMITTED 

0007 

SEQUENTIAL 




EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

EXTENT LIMITS OMITTED 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 












00 

1 (PRIME DATA) 

SYSRDR CCB FORMAT 0000 
OMITTED 




STANDARD LABELS (ALL PARTITIONS-PERMANENT) 


TRACKS 


10-19 FOR 2314,10-18 FOR 3330, 10-11/0-11 FOR 3340, 


OR 10-29 FOR 3350 


IJSYSRS 

FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 












OOS.SYSRES.FILE 

mill 

01 

OMITTED 

99/365 

SEQUENTIAL 




EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE (TO ZERO) START 

NUMBER OF TRACKS 

SYMBOLllC UNIT 

VOLUME SERIAL NUMBER 


ADDRESS 


IN 


TRACKS 


01 

1 (PRIME DATA) 

0001 

3959 

SY SR E S CC B FORMAT 00 06 

mill 




IJSYSLN 

FILE IDENTIFIER 












OOS.UORKFILE.NO.O 


(& 33/f xr) 




FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 



DOS LABEL CYLINDER DISPLAY 



COMPARE-FILE FOR TESTCASEOUTPUl 

TESTVl 

01 

OMITTED 

69/001 

DIRECT ACCESS 



EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE (TO ZERO) START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 

EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVF (TO ZERO) START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



END OF LABEL CYLINDER DISPLAY 



00 

1 (PRIME DATA) 

0006 

3874 

SYS005 CCB FORMAT 

TESTVl 



WORK FILE FOR SLIB 

TESTVl 

01 

OMITTED 

69/001 

DIRECT ACCESS 



00 

1 (PRIME DATA) 

3880 

0100 

SYSOIO CCB FORMAT 

TESTVl 



(eK33Biery 



^%, An example of some of the output to a line printer after executing the LSERV program, part 2. 
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Library Display Programs and Utilities 
LSERV 

// DLBL filename, 'file ID', date, codes, data security 

// EXTENT symbolic unit, serial number, type, sequence number, relative track, number of tracks, split cylinder track, B bins 






JOB CONTROL statements, 

for details see DOS/VS System Control Statements 



II DLBL IJSYSRS,'DOS.RECORDER.FILE',99/365,SD 
// EXTE NT SYSR EC, 111111,1,1,3960,20,, 



May also be printed as 
RETENTION PERIOD (DAYS) 
Depends on the manner used to 
specify date in the DLBL 
statement. 




FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 



EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE ITO ZERO! START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 

(■ CREATION DATE 

\ EXPIRATION DATE 
FILE TYPE 

EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 
EXTENT TYPE 
EXTENT LOHER LIMIT 

EXTENT UPPER LIMIT 

SYMBOLIC UNIT 
VOLUME SERIAL NUMBER 



FILE IDENTIFIER 
FILE SERIAL NUMBER 
VOLUME SEQUENCE NUMBER 
CREATION DATE 
EXPIRATION DATE 
FILE TYPE 

EXTENT INFORMATION 

EXTENT SEQUENCE NUMBER 

EXTENT TYPE 

RELATIVE (TO ZERO) START ADDRESS IN TRACKS 

NUMBER OF TRACKS 

SYMBOLIC UNIT 

VOLUME SERIAL NUMBER 



DOS LABEL CYLINDER DISPLAY 



mill 

01 

OMITTED 

99/365 

SEQUENTIAL 



01 

1 (PRIME DATA! 

3880 

0060 

SYS004 CCB FORMAT 

mill 



DOS. RECORDER. FILE 

mill 

01 

OMITTED 

99/365 

SEQUENTIAL 



(PRIME OATAt 



CYLINDER 

HEAD 

CYLINDER 

HEAD 

SYSREC 

mill 



198 
19 
CCB FORMAT 



NAME-LIST 

HELP#1 

01 

OMITTED 

69/001 

DIRECT ACCESS 



00 



1 (PRIME DATA) 

0020 

0003 

SYS005 CCB FORMAT 

HELP»1 



J^x3f'/i1^ 



Relationship between DLBL/EXTENT card data and the information printed by the LSERV program. 



y 
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Under certain circumstances knowing the contents of libraries can be helpful 
during program debugging. The Library display programs DSERV, CSERV, PSERV, 
SSERV, and RSERV enable you to print an image of: 

• Any library directory 

• Any library 

• Any program in any library 

• Any phase in any library. 

When using DSERV, a System Status Report is always printed before the specified 
directory. A private status report is also printed when private libraries are used 
with the system. 

An example of a system status report is shown in two examples at the end of the 
section describing the Linkage Editor Map (E-4 of this manual). 



Library Display Programs and Utilities 

LIBRARY DISPLAY 




o 



When and how to use 

Control statements required to execute the library display programs are shown in 
the next two tables. 

The following list gives some examples of when to use the various library display 
programs: 

I l.j The operator action given under the appropriate message in DOS/ VS Messages 
indicates when to execute DSERV. 

For example, under the message: 

1C33A PROGRAM NOT FOUND 

When error message instructions include a library display, enter statements that 
correspond to the library and type of display. Be sure to substitute the actual 
program module, book, sublibrary or phase name for the words phase 1 , module 1 , 
book 1 , sublib 1 , or prog 1 . 

Note: If you assign a private library and display that type of library, only the private 
library will be displayed. To obtain a display of the system library, the private 
library must be unassigned. 

Additional information on the display program is found in DOS/VS System 
Control Statements. 

Further recommendations as to when to use the library display programs are given 
after the two tables following. 
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LIBRARY Control statements required to execute the Library display programs 

DISPLAY 






Unit 


Element 


Control Statements Required 


Core Image 
Library 


Phase 


//JOB jobname 
//EXECCSERV 
DSPLY phasel rphase2,..."| 

/* 

/& 


Program 


//JOB jobname 
//EXECCSERV 

DSPLY prog1.ALL[prog2.ALL,..n 
/* ^ 

/& 


Library 


//JOB jobname 

//EXECCSERV 

DSPLY ALL 

/* 
/& 


Directory 


//JOB jobname 

//EXEC DSERV 

DSPLY CD 

/* 
/& 


Relocatable 
Library 


Module 


//JOB jobname 
//EXECRSERV 
DSPLY moduleirmodule2,..."j 

/* 
/& 


Program 


//JOB jobname 
//EXECRSERV 
DSPLY prog1.ALLrprog2.ALL,..."l 

/* "■ 
/& 


Library 


//JOB jobname 

//EXEC RSERV 

DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 

DSPLYRD 

/* 
/& 


Sorted 
//JOB jobname 
//EXEC DSERV 

DSPLYS RD 

/* 
/& 



'V.,;.>'^' 



Table C-2 Library Display Control Statements (Part 1 of 2) 

Note: To execute DSER V, SYSIN must be assigned to a card reader, a tape unit, a disk drive, 
or diskette unit. SYSLOG must be assigned to a 1052, 3210 or 3215 console printer, or a 
display console. 



.^ 
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O 



Unit 


Element 


Control Statements Required 


Source 

Statement 

Library 


Book 


//JOB jobname 
// EXEC SSERV 

DSPLY sublib.bookl [,sublib.book2,...] 

/* 
/& 


// JOB jobname 
// EXEC ESERV 
DSPLY E. bookl 

Te. book2,...l 

/. L J 

/& 


Sub- 
library 


// JOB jobname 
//EXEC SSERV 

DSPLY sublibi .ALL[,sublib2.ALL,...] 

/* 
/& 


Library 


//JOB jobname 
//EXEC SSERV 
DSPLY ALL 

/* 
/& 


Directory 


Unsorted 
// JOB jobname 
// EXEC DSERV 
DSPLY SD 

/* 

m 


Sorted 
// JOB name 

// EXEC DSERV 
DSPLYSSD 

/• 
/& 


Procedure Library 


Directory 


Unsorted 
// JOB name 
// EXEC DSERV 
DSPLY PD 

/* 
/& 


Sorted 
// JOB name 

// EXEC DSERV 

DSPLYSPD 

/• 
/& 


Library 


// JOB jobname 
//EXECPSERV 
DSPLY ALL 

/* 

/& 


Procedure 


// JOB jobname 
//EXECPSERV 

DSPLY procedurel [,procedure2,..] 


Directories 


All 


Unsorted 
// JOB name 

// EXEC DSERV 
DSPLY ALL 

/* 
/& 


Sorted 
// JOB jobname 

// EXEC DSERV 
DSPLYSALL 

/• 
/& 


System 

Directory 

List 




// JOB jobname 
// EXEC DSERV 
DSPLY SDL 

/* 

/& 



LIBRARY 
DISPLAY 




CI 



Table C-2 Library Display Control Statements (Part 2 of 2) 

Note: To execute DSER V, SYSIN must be assigned to a card reader, a tape unit, a disk drive, 
or diskette unit. SYSLOG must be assigned to a 1052, 3210 or 3215 console printer, or a 
display console. 
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LIBRARY DISPLAY 



2, Execute DSERV when you require details about the core image library. 



■ 




Hi 


HH 




HH 




HHHHHHH 




^M 














03'06'7'* PAGE- 10 
















^M 


PHASE DISK TXT BTS LST 


RLD 


RLD 


LOAD 


ENTRY 


PART ENTRY SVA IN 






H 


NAME ADDR RCDS TXT RCD 


RCDS 


ITEMS 


ADDR 


ADDR 


ADDR ADDR ELIG SDL 
























^^1 


C H R 
















^^1 


_^ $$RAST13 007 02 05 001 0582 






000000 


OOOOOO 








^^1 


# $IJKS00 008 03 02 001 0536 






000000 


OOOOOO 








^^1 


$1JKS10 008 03 03 001 028't 






000000 


OOOOOO 








^^1 


$IJKS20 008 03' Ol* 001 0't88 






000000 


OOOOOO 








^^1 


# tlJKSSO 008 03 05 001 0592 






OOOOOO 


OOOOOO 








^^1 


$IJKS't0 008 03 0'6 001 0392 






000000 


OOOOOO 








^^1 


^ $IJKS50 008 03 07 001 0360 






OOOOOO 


OOOOOO 








^^1 


• $IJKS$0 008 O"* 01 001 0672 






OOOOOO 


OOOOOO 








^^1 


*IJKS70 008 O"* 02 001 058i* 






OOOOOO 


OOOOOO 








^H 


$IPLRT2 007 O"! 07 006 0072 






OOOOOO 


000C68 








^H 


• $IPLRT3 007 05 06 003 02118 






000C68 


000C68 








^H 


$IPLRTit 007 06 02 006 0't2it 






000C68 


O0OC68 








^H 


$IPLRT5 007 07 01 005 02'tO 






000C68 


00OC68 








^H 


• tJOBACCT 007 10 O"* 001 0002 






OOOOOO 


OOOOOO 








^H 


$dOBCTLA 001 03 05 009 0720 






OOOOOO 


001810 








^H 


$dOBCTLB 001 0"* 07 001+ 03'tO 






001810 


001810 








^H 


• $dOBCTLD 001 05 O** Oil 0520 






001810 


001310 








^H 


$>JOBCTLE 001 07 01 007 0610 






001810 


•001810 








^H 


$JOBCTLF 001 08 01 006 O'*'*'* 






001810 


001810 








^H 


• $dOBCTLG 001 08 07 006 0156 






001810 


001810 








^H 


$JOBCTLd 001 09 06 008 0208 






001810 


00181 








'^H 


$JOBCTLK 001 10 07 005 0972 






001810 


001810 








^H 


• $dOBCTLM 001 11 05 007 0168 






OOOOOO 


' o'ooooo 








^H 


$J08CTLN 002 OO 05 001 078") 






001810 


001810 








^H 


$LIBSTAT 007 0"* 02 OQit 098't 


001 


00011 


OitOSOO 


01(0800 


01*0078 YES 






'^H 


• $LNKEDT 007 07 06 019 0i*91 






OOOOOO 


003EC8 








^H 


$MAINDIR 007 02 06 010 0976 


000 


00011 


01*0800 


0't0800 


01*0078 YES 






^H 


ALIST 009 05 O"* 012 0628 


001 


00100 


O't0078 


040300 


01*0078 






^1 


• ALTDC 009 07 03 001* 0700 


000 


00053 


0't0078 


0't031A 


01*0078 






.^1 


ALT0C2 009 07 07 009 0879 


000 


00019 


O'tOSDO 


0i|05DA 


01*0078 










PHASE NAME 


The nanries of programs (phases) 


DISK ADDR 


The disk address of the phase on the core image library (Disk address of first text, TXT, record) 


TST RCDS 


The number of records belonging to the phase (Number of TXT records) 


BTS LST 
TXT RCD 


The number of TXT bytes in the last TXT record 


RLD RCDS 
(see note 1 ) 


The number of additional relocation list dictionary (RLD) records, referring to the address constants in the text 
that will bs modified by the relocating loader ' 


RLD ITEMS 
(see note 1 ) 


Total number of RLD items that show the total number of TXT modifications due to relocating load 


VER MOD 
LEV LEV 
(see note 2) 


The version and modification level of phases, modules, and books in the core image, relocatable, and source 
statement libraries respectively. 


LOAD ADDR 


The load address of the phase at the time it is link-edited to core image library (Link-edit time) 


ENTRY ADDR 


Entry address of the phase at link-edit time 


PART ADDR 
(see note 1 ) 


Start address at link-edit time of the partition to which the phase is link-edited 


SVAENTRYADDR 


The entry address in the SVA of the phase contained in the SVA. (These phases can be loaded into the SVA after 
IPL or by cataloging them into the SVA during system operation.) 


SVA ELIG 


A YES in this column indicates that it is permissible to load the phase in the SVA either after IPL time or during 
system operation using the linkage editor. 

(It indicates that the phase is reenterable and relocatable which it must be to enable its use by the system when it 
resides in the SVA.) 


IN SDL 


A YES in this column indicates that the name of the phase is in the SDL. 

Note: A phase name can be present in the SDL but need not necessarily be present in the system core image 

library. 



/- A. 



Notes 1. Entries are printed in these columns only when a relocatable phase is found in the library. 

2, Version and modification levels are always listed for modules and books displayed, but are listed for phases 
only when displaying a specific phase. This information is required under some conditions of system mal- 
functions that may be caused by the use of programs at different levels of modification. 

Most IBM-supplied programs have a 2-byte VM (version and modification level) number. The number may be 
in decimal or hexadecimal form in a storage dump, depending on the input format. It is in decimal form in a 
DSERV printout of the source statement or relocatable library. For example, version 5 modification level 
appears at 2800 or F2F8 in a storage dump and a 5.0 in a DSERV printout. The VMs for phases and transients 
are contained within the phase or transient. 

Your IBM CE/FE can also check your library by using DSER V to examine it for the applicability of an IBM- 
supplied program temporary fix (PTF). 

The modification level of your library is also required if an authorized program analysis report (APAR) must 
be submitted to IBM for analysis of a particularly difficult programming error. 
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3. 



Similar information is displayed by the DSERV program for the following 
directories: 



Library Display Programs and Utilities 

LIBRARY DISPLAY 



• Transient 

• Relocatable 

• Source statement 

• Procedure 

Use CSERV to display a phase and compare it with the program listings for the 
phase when, for example, a program using that phase produces incorrect resuhs 
after having run successfully in the past. RLD information for any relocatable 
phases will also be displayed. 

Use PSERV to check job streams cataloged in the procedure library if they are 
suspected of causing program errors. Before modifying any job stream on this 
library, use PSERV to enable checks to be carried out on the modifications. This 
helps to reduce errors when using the overwrite function of the catalog procedure. 

Note: The procedure library itself can be used as a secondary debugging aid. 
It is useful to catalog job streams that initiate or execute the more frequently 
used debugging aids, or aids requiring complex Job streams. For example, time 
will be saved ifEREP or trace routine job streams are kept on the procedure 
library. 

Use RSERV when, for example, a modification must be made (via REP cards) 
to an object module in the relocatable library. An example of an RSERV 
output is shown below: 




" 


POAIDGTM V.M 


29.0 






00004 BLOCKS 


SYSTEM 


RELOCATABLE LIBRARY 










PHASE PDAIOGTM 


'«'OtNOAUTO 
























ESD 




016 


0001 




PC 000060 00017C 














TXT 


000060 


136 


0001 


07FA070A 


07FA070A 


47F09120 


42C09108 


58C0 0O8O 


9500C045 


4770909A 


95009 lOB 














0;78A9500 


910B078A 


95009108 


078A950Q 


9103 078A 


95 0091 OB 


078A9078 


910C4700 












90CA4iaO 


903B4170 


000695FF 


80004780 


90CAD50O 


SOOOOOSB 


478090C0 


468090C6 














9878910C 


07FA4670 


90AA5870 


9118D207 


70000020 


90017008 


D2O07OOC 


008B58B0 














00144880 


805A4A80 
















TXT 


0000E8 


040 


0001 


910AD201 


70108002 


41770012 


59709 UC 


47409100 


58 709114 


50709118 


9878910C 














O7FA00O0 


00000012 


















TXT 


000114 


136 


0001 


00000000 


00000000 


00000000 


92009069 


0200 9070 


90480200 


90839049 


02009089 












904A0200 


90BF904B 


02009095 


904C95FF 


903B4770 


915492F0 


909F47F0 


917090CA 














9180905B 


47109170 


0201 90B0 


90BA0201 


90BA9152 


927090B0 


928090C7 


95009070 














4770917E 


D201907A 


91DA9057 


912095FF 


903:4780 


91C05850 


903C5B60 


9040ff203 












90549040 


1B651876 


















TXT 


00019C 


064 


0001 


1B665D60 


910C4C70 


910E4B70 


913EIA75 


50509114 


50509118 


507091 IC 


98579120 














47F091CC 


41509120 


58690000 


47F09198 


58B09114 


D711B003 


B00047F0 


906CA000 




END 


404040 
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Use SSERV to examine the contents of a book. Use it, for example, to check 
if changes are required to privately written macros cataloged into the source 
statement library, in unedited macro format. 

Use ESERV to examine the contents of an edited assembler macro. 
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Library Display Programs and Utilities 
ESERV 



This service program de-edits macros contained in the source statement library. 
When the source macro definition is not available, ESERV enables you to de-edit 
the edited macro to source format. Several macros can be de-edited at one time. 
ESERV also combines the function of de-editing vi^ith that of updating the source 
macro definition. 

The ESERV program allov^s you to: 

• De-edit and update a macro definition 

• Obtain a printout of the de-edited macro definition 

• Obtain a printout and a punched card deck of the de-edited macro definitions 

• Verify and update statements from a printout of the source macro definition. 

For a detailed description of the control statements used by this program, refer to 
the Guide to the DOS/ VS Assembler. The logic of the ESERV program is described 
inDOS/VS Assembler Logic. 

Input consists of ESERV control statements entered via SYSIPT, and the edited 
macro definition in the macro library. 

Output consists of: 

• The selected macro definitions in source format (and updated) on the device 
assigned to SYSPCH and/or the device assigned to SYSLST. 

Note: To allow immediate editing of the updated macro, an END card can be 
generated at the end of the update run. 

• Update information 

• Error diagnostics. 

The illustration opposite shows the input and output of the ESERV program. 
How to use 






r 



Seven control statements are available to update the de-edited source macro definitions. 
These are described in the table below: 



COL: 


for specifying the columns containing the sequence numbers in the statements of a macro definition 


ADD: 


for adding source statements to a macro definition 


VER: 


for verifying the contents of a specific source statement of a macro definition 


DEL: 


for deleting source statements from a macro definition 


REP: 


for replacing source statements in a macro definition 


RST: 


for specifying a new number sequence 


END: 


for indicating the end of an update to a macro definition. 


Note: Each update control statement is printed on SYSLST followed by (except for RST) the affected source statement. This printout 
is known as the update survey. For ADD, the de-edited source record preceding the records to be added is printed, followed by the 
added records. For VER, the character string to be compared is printed, followed by the de-edited source record to be verified. For 
DEL, the de-edited source records to be deleted are printed. For REP, the de-edited source records to be replaced are printed, followed 
by the records to be inserted. 



Errors During Update 

If an error is detected during updating, a message is printed on the update survey. 
The requested update action will not be performed. If possible, updating will 
continue with the next update control card. Otherwise, a termination message is 
given and only the remaining update control cards are printed on the survey. 
De-editing of the macro will always be completed. The job will be canceled at the 
end of the ESERV run; that is, remaining jobsteps to edit the macro and catalog 
the EDECK again will not be executed. 
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Updating will continue with the next update control card for all errors except when: 

• The COL statement has invalid operands. 

• COL statement is not the first update control statement. 

• The macro is completely de-edited without all update control statements 
being completely processed. 

• An RST statement has an invalid operand. 

Appendix D shows two ESERV job stream examples. 



ESERV 




macro source 
deck 



SYSIPT 




SYSPCH 




o 



ESERV 




SYS001/2 

This illustrates the input to and output from the ESERV 



SYSLST 



When to use 



• Use ESERV to create a macro source deck. 

• ESERV can be used to list the source code of an edited macro. 

• If an IBM program tempory fix (PTF) is to be installed in your library, use 
ESERV to de-edit and update the macro. An example of installing a PTF 
using ESERV is given in appendix D. 

Note: Before installing a PTF use either ESERV or SSER V to display the macro in 
order to check if the PTF is applicable. 
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LVTOC 



The LVTOC program enables you to print out VTOC (volume table of contents) of 

a DASD disk pack. ^ |\ 

\ y 

From the printout (the VTOC display), you can see the names of files, contained ' 

on any disk pack, their extents, and addresses. A VTOC display, therefore, enables 
you to keep track of data sets and files on all your packs. 

Additional information on the VTOC display program can be obtained from 
DOS/VS System Utilities. 



Information in the VTOC 

All standard file labels are grouped together and stored in a specific area on a disk 
pack or data cell. This group of labels is essentially a directory of all data records on 
the volume because each file label contains file limits. Therefore, this group of 
labels is called the volume table of contents, or VTOC. Because the VTOC itself 
is a file of records containing one or more standard label records for each logical 
file, it is defined as such with its own file label. 



Last 

Volume 

Label 



VTOC 
File Label 
(Format 4) 



VTOC 
File Label 
(Format 5) 
(Used by 
OS/VS 
only) 



File 
Labels 



Filename = 

xxxxxx 

Format 1 
Label 



Additional 
File Labels 



Filename = 
XXXXXX 
Additional 
Extents 
(Format 3) 



Pointer to 
last active 
file label 



Pointer to 
additional 
file extentsj 
if necessary. 



Function of the VTOC 

Before a DASD file can be processed by logical IOCS, the file must be opened to 
permit transfer of data. The open routines check the DASD labels identifying the 
file. This is accomplished by comparing the information from the actual file 
labels in the VTOC with the label information in the SYSRES label information 
cylinder. (See LSERV in this Section for a description of the label cylinder.) 

The illustration opposite is a overview of how DOS/VS uses the VTOC. 

DASD Label Formats 

The VTOC contains all format labels. Each format label points to an area of DASD 
storage on the volume and indicates what the area is currently being used for. A 
format 1 label describes one to three physical areas (extents) on the volume. It is 
the first format label used to describe each file. 

A format 2 label describes a file as being indexed sequential. If a format 2 label is 
used, there is always a format 1 label describing the same file. 

A format 3 label describes from one to thirteen extents on the volume. It is used 
when a file is made up of four to sixteen extents (the format 3 label is always 
associated with a format 1 label). 

A format 4 label describes the VTOC. 

A format 5 label is not used by DOS/VS. 

The following illustrations show the layout of format labels 1 to 4, with examples 
of printouts from the VTOC display program. 

A detailed description of these label formats is given in DOS/VS Data Management 
Guide. 



V. y 



-^ 
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Library Display Programs and Utilities 

LVTOC 



Filename for DTF matches 
filename in DLBL statement 



Job 
control 



o 



//DLBL Filename, File ID , etc. 

// EXTENT Symbolic name. Volume number 



Standard Volume Label: 
Cylinder 0, Track 0, Record 3 
(Written during disk 
initialization) 



The VTOC 
Format 4 label 



#1l 




Label information 
cylinder 




SYSRES 



During the OPEN routine: 

1. Read SYSRES label information. 

2. Locate the VTOC via the 
standard volume label. 
For DASD input files: 
Compare format 1 label information 
(or format 2 for IS files) to information 
in the DLBL card. 
Check each extent definition in 
format 1 and 3 labels against the 
limit fields in the EXTENT card(s). 
For DASD output files: 
Create the format 1 label from 
information in the DLBL/EXTENT 
cards. (Format 1 is always present 
followed by format 2 for IS files). 
If extra extents are to be described 
create format 3 labels following 
the format 1 or 2, or another format 3. 

During the CLOSE routine: 
1 . Read, update, and rewrite format 1 labels 
(and format 2 labels for IS files). 



An overview showing how the DOS/VS uses the VTOC. (Not applicable to VSAM 
files) Details are found in DOS/VS LIOCS Vol 1 



Serviceability Aids 2. 1 29 



Library Display Programs and Utilities 

LVTOC Executing the VTOC display program 



The control cards necessary to execute VTOC in a virtual partition are: \„y 

// JOBjobname 

// ASSGN SYS004,X'cuu' (input) 
// ASSGN SYS005,X'cuu' (output) 
// EXEC LVTOC 

/& 

The operator commands necessary are: 

1. Press REQUEST on the console printer keyboard 

2. PAUSE (BG, Fn), EOJ 

3. // ASSGN SYS004,X'cuu' (input device) 

4. // ASSGN SYS005,X'cuu' (output device) 

5. // EXEC LVTOC 

Where: 

• SYS004 is assigned to the channel and unit address (cuu) of the DASD on 
which the disk pack is mounted. 

• SYS005 is the output device, normally a printer. If the output device is not 

a printer, TLBL, DLBL, and EXTENT cards must be included to describe the 
output device. The filename for these cards is UOUT. 

The first of the two examples on the opposite page is a VTOC display using the 
LVTOC program. 

Two other methods of obtaining a VTOC display are as follows: 

• Instead of typing CANCEL to terminate the job, the operator can type 
CANCELV in response to an error message to get a VTOC dump on SYSLST, /- n 
ifSYSLST is a printer. Refer to the second example on the opposite page. L 

• The operator can display the VTOC by typing DSPLYV (in response to an 
error message). This reply does not terminate the job, but reissues the same 
message issued prior to the VTOC display request. (The output can be 
directed to SYSLOG if SYSLST is not assigned.) Refer to the example at the 
end of this chapter. 

Operator actions given in DOS /VS Messages indicate methods to obtain a VTOC 
display for particular messages. 



When to use 

The five examples Msted below illustrate when and how the VTOC display program 
can aid program debugging by providing details about your disk volumes: 

1. During disk pack initialization, the VTOC label is checked. A message is printed 
on SYSLOG if there is an unexpired file in the pack. If the contents of the pack 
are unknown or its vahdity is in doubt, a VTOC listing will enable you to check 
the unexpired file. You can then decide if the unexpired file is to be retained 

or replaced by different extents. 

2. Before copying a volume it is useful to keep a record of the contents of the 
volume to be copied and the volume that receives the copy. Having a record will 
reduce debugging time if an error occurs in a program that uses one or both of 
these packs. 

3. A VTOC display enables you to monitor and keep track of volume areas, thus 
allowing economical use of your packs. 

4. If the input data contained on a pack is causing program errors, a VTOC listing 
of the input volumes enables you to check for the presence (or absence) of data 
sets. 

5. If, during program execution, a system malfunction prevents workfiles from 
being properly closed by the CLOSE macro, it is probable that volumes used 
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during the program will cause program errors when used for future jobs. This is 
because the VTOC label would not have been updated by the CLOSE macro. It is 
useful, therefore, to obtain a VTOC listing of the volumes affected. 



LVTOC 



Examples of the LVTOC output 



o 





1 






HH 












VTOC DISPLAY UTILITY 












' LABEL IDENT - 


VOLl VTOC LOCATION IS CYLINDER - 199 SERIAL NUMBER - lUlll OWNER 


IDENT - 








' T O.R 1 FORMAT * 


LAST ACTIVE UNUSED ALTERNATE TRACK INFORMATION 
FORMAT 1 LABELS LOCATION NO. OF TRACKS 

473 200 60 


EXTENT INFORMATION 
SEQ TYPE LOH HIGH 

PRIME 199 199 18 








' T O.R 2 FORMAT 5 


USED ONLY BY 0/S NOT SUPPORTED BY DOS/VS 












' T O.R 3 FORMAT 1 


SERIAL NUMBER - llllll LENGTHS DATES 
FILE ID KEY BLOCK RCD CREATE EXPIRE 


SYSTEM 
IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 








' PAGE DATA SET 


2048 2048 73 278 99 365 


IBMDOSVS 


180 186 19 








' T O.R 4 FORMAT I 


SERIAL NUMBER - llllll LENGTHS DATES 
FILE ID KEY BLOCK RCD CREATE EXPIRE 


SYSTEM 
IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 








' DOS. RECORDER. FILE 


73 278 99 365 


IBMDOSVS 


1 PRIME 198 Cf 198 19 








' T O.R 5 FORMAT 1 


SERIAL NUMBER - llllll LENGTHS DATES 
FILE ID , KEY BLOCK RCD CREATE EXPIRE 


SYSTEM 
IDENT 


EXTENT INFORMATION 
SEQ TYPE LOW HIGH 






o 


' JBUG.GENERATOR.MQRKF 
' T O.R 8 FORMAT I 


ILE.K.TOMS^^^^^-J^^^O^ 


73 278 73 249 


IBMDOSVS 

SYSTEM 
IDENT 


1 PRIME^21 14 41 13* 

EXTENT INFORMATION 
SEQ TYPE LOW HIGH 




SERIAL NUMBER - llllll 
FILE ID 


LENGTHS 
KEY BLOCK RCD 


DATES 
CREATE EXPIRE 




Di 


' DOS.WORKFILE.NO.O 
' END OF VTOC LISTINC 


/^ 





73 278 99 365 


IBMDOSVS 


1 PRIME 10 20 19 




/JZ/JckaM. ^ rs/iH ^^ 




1 






IBH 








An example of the output on a line printer after executing the LVTOC program 



o 




An example of the output on a line printer after issuing the CANCELV command 
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LVTOC 



if' ^ 
'\ /' 



;Br7 ASSGN SYSPCHi-X'i;?!' 

:BB 4444A OVE".Rl.AP ON UNEi.XPRD FILE 

BUG . GENERATOR r WORKFILE , K . TOMS 
1 BO d<iP I Y V ^ : 



;BG 4U95A SYSLOG OR SYSLST 
iBG r> Y'i I o<9 

;bg 



BG VOLUME SERIAL NO,, IS ;l.:l.1.1.:L1. 



iBG PAGE DATA SET 

1 BG 2 J. 00 OOB40000-OOB AOO 1. 3 



IJSYSPH SYSPCH=131. 1.11.111. 



1111111 0001 



10/04/13 
0D0115-63016ri 



;BG DOS. RECORDER. F-ILE 

IbG 0101 OOCAOOOO~0(M:60013 



1111111 0001 0D0115-63016D 



I BG C<BUG . G ENERATOR fWORKFILir. K . TOMS \ 1111111 (OOOl) 0D0115-4900F9 

iBG^rwoi^ircoiieop-i)^^ >~~r 7^T7~~7^ i^^<^ 

]BG DOS.WORKFILE.NO.O ^ 1111111 0001 0D0115-A301AD 

■BG 0101 00010000-00140013 

;bg vtoc display completed 



An example of the output on a 321 5 console printer keyboard after issuing the 
DSPLYV command. 







An example of the output on a line printer after issuing the DSPLYV command. 
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The SYSVIS DUMP program copies the contents of the page data set (PDS) S YS V I S D U MP 

contained on the system logical unit SYSVIS on to magnetic tape or disk pack. 

A printout on SYSLST can then be obtained for use during offline program 

debugging. The utiUty also enables you to dump the contents of the PDS directly 

to SYSLST, which can be assigned to a tape unit, a disk drive, or a line printer. S^S V \S I "S Of "^^ jO^^^ ^^- ^ ^^^^ ^^ 

The SYSVIS dump may also be referred to as the Page Data set dump. ^«^^& \{iKrof^L. S^rbk «:k'^&. pfyC'&limi^ S^. 

Restrictions 

This utility program can be used only to copy or dump the contents of the PDS 
contained on SYSVIS. Any other use is automatically rejected by the system. 
Because paging must not occur during execution of this utility when dumping 
from SYSVIS do not start or run any other jobs either before or during its execution. 

Description and operation 

This utiUty program is initiated by normal JCL through SYSLOG or SYSIPT by 
the execute statement // EXEC PDSDM. Parameters entered either through 
SYSLOG or SYSIPT enable you to select areas of SYSVIS, thus avoiding the 
need to dump all of the virtual address area contained on SYSVIS. 

The following areas can be selected: 

• The entire PDS , that is, all the virtual address area 

• Any specified virtualpartition 

• One or more pages contained within any virtual partition. 

Multiple parameters can be specified but they must be confined to one card 
image. Multiple cards are possible. 

For example: 

BG, (089ABC,08ABCD), F4 punched in a card or entered through SYSLOG 
causes a dump of the whole of the background and foreground 4 virtual 
partitions, and the pages on the PDS that contain any addresses between the 
address limits 089ABC and 08ABCD. 

(Addresses are specified by six hexadecimal digits.) 

The dump output is directed to SYSLST or SYSOOl, depending on the parameters 
specified. For example, a response of SYSLST to the message 0V23D T0= causes 
the dump to be directed to the device assigned as SYSLST. 

If SYSOOl is used as the input or output device, tape or disk label information 
must be supplied in the job stream. 

If the dump is from SYSVIS, it is accessed by assigning SYSOOO to it. The 
necessary disk label information must then also be supplied in the job stream. 

Job stream examples are shown on the following pages. 

The format of the dump output is similar to the output obtained from the 
stand-alone dump, that is, each 2K of virtual storage contained on the PDS is 
separated and given a block number starting with BLOCK 0000. Blocks 
containing only zeros are suppressed. An example of the stand-alone dump 
output is shown in Appendix G. 
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SYSVIS DUMP How to execute 



Because this utility consists effectively of three separate utility programs, it is 
necessary to show three sample job streams. 

Example 1 shows the job stream required to copy SYSVIS to SYSOOl, where 
SYSOOl can be assigned to either a tape unit or a disk drive. 

Example 2 shows the job stream required to dump SYSOOl to the device assigned 
to SYSLST. 

Example 3 shows the job stream required dump SYSVIS directly to the device 
assigned to SYSLST. 

To ensure that the contents of the PDS and the allocations of the virtual address 
area are the same as they were just prior to the execution of the stand-alone dump 
the following instructions must be adhered to: 

1 . Re-IPL using identical parameters for the DPD command as specified in the 
previous system IPL. However you must specify N to the parameter TYPE=. 

2. Check for any previous ALLOC commands. You must specify identical virtual 
partition allocations as existed just before the stand-alone dump was executed. 

Example 1: Copying SYSVIS to SYSOOl on tape or disk. 
(SYSOOl must be a DASD device) 

// JOB COPYPDS where CUU is the physical address 

// ASSGN SYSOOCX'cuu' of SYSVIS. 

// ASSGN SYSOOl ,X'cuu' where CUU is the physical address 

of the device to be used as 
temporary storage for the PDS. 

// DLBL PDSDISK/PAGE DATA SET 

// EXTENT SYSOOO 

// DLBL SOI DISK/BACKUP FOR PDS' [,date] 

// EXTENT SYSOOl, vol ID,„relative starting address, number of tracks 






\.-.>' 



If the PDS copy is to be on tape, replace the previous two statements by the 
following: 

// TLBL PDSTAPE/BACKUP FOR PDS' 

followed by: 

// EXEC PDS DM where PDSDM is the phase name 

for the utility contained on the 
system core image library. 



When message 0V20D ist displayed, enter the appropriate response (see DOS/VS 
Messages). Pressing END as a response to this message causes the complete PDS 
to be dumped to SYSOOl. 
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Example 2: Dumping SYSOOl to SYSLST SYS VIS DUMP 

// JOB DUMPPDS 

// ASSGN SYSOOl ,X'cuu' where cuu is the physical 

address of the device containing 

the copied PDS. 
// DLBL PDSDISK/BACKUP FOR PDS' 
// EXTENT SYSOOl 

If the copied PDS is on tape, replace the previous two statements by the following: 

// TLBL PDSTAPE/BACKUP FOR PDS' 
followed by: 

// EXEC PDSDM 

If parameters are to be read through SYSIPT respond to message 0V20D with 
IPT, press the END key and use the following statement: 

TO=SYSLST, T followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with LOG and press END if parameters are to be 
read through SYSLOG. 

Only pressing the END key as the answer to message 0V20D causes a dump of the 
whole PDS to SYSLST. 

If LOG is entered followed by END key the following message is issued on 
SYSLOG: 

0V23DTO= 

Respond to this with: 

SYSLST ,T This selects SYSOOl as input device and SYSLST as output 
device for the dump. 

This is followed by the message: 

0V21D GIVE PARAMETERS- 

Pressing the END key after entering parameters causes an immediate dump of the 
areas specified followed by the message: 

0V21D GIVE PARAMETERS 

Further parameters can be entered but if no more areas of the PDS are to be 
dumped, either enter EOJ or press the END key. This terminates the job. 

Note: On Models 1 15 and 125 the END key is replaced by the ENTER key. 
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SYSVISDUMP 



Example 3: Dumping SYSVIS direct to SYSLST. 

// JOB DUMPPDS 

// ASSGN SYSOOO,X'cuu' where cuu is the physical address of 

SYSVIS. 
// DLBL PDSDISK/PAGE DATA SET 
// EXTENT SYSOOO 
// EXEC PDSDM 

If parameters are to be read through SYSIPT this must be followed by: 

TO=SYSLST followed by the cards containing the parameters and 
/& 

Respond to message 0V20D with either LOG or IPX and press the END key. 
(END key only is an invalid response .) If LOG is entered followed by END key 
the following message is printed on S YSLOG : 

0V23DTO= 

Respond to this with SYSLST. This selects SYSVIS as input device and SYSLST 

as output device for the dump. 

This is followed by the message; 

0V21D GIVE PARAMETERS 

Pressing the END key after entering parameters causes an immediate dump of the 
specified areas of SYSVIS and is followed by the message : 

0V21D GIVE PARAMETERS 

Further parameters can be entered, but if no more areas of SYSVIS are to be 
dumped either enter EOJ or press the END key to terminate the job. 

Pressing the END key before entering parameters causes the whole PDS to be 
dumped on SYSLST. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 






w_ _^ 
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Error messages SYSVIS DUMP 

The list below summarizes the error messages that are printed on SYSLOG to 
inform the operator of incorrect job stream input: 

Invalid parameters are specified. 

SYSLST or SYSOOl is incorrectly specified. 

Start address is greater than end address. 

Partition is not allocated. 

Address or partition is in real storage. 

Address is greater than end of virtual storage. 

Partition ID is invalid or greater than number of partitions allocated. 

Incorrect assignments for SYSOOO and/or SYSOOl. 

Attempt to dump a file other than the PDS. 

Incorrect addresses and partition IDs are flagged by an asterisk (*) printed on the 
line below. For example: 

BG bg,0809ab,f4,148000,05f5ee, (0809ab,096000)f2, 

BG 

BG 0V20I A 

BG bg,0809ab,f 4, 1 48000,05f 5ee,(0809ab,0960G0)f 2, 

BG 

BG 0V40I ADDRESS IS OUTSIDE OF VIRTUAL PARTITIONS 

Pressing the END key causes the areas that are specified correctly to be dumped up 
to the first invalid parameter. The incorrect parameters can be corrected through 
SYSLOG. If the input is through SYSLOG, further parameters can be specified 
after the message: 

0V21D GIVE PARAMETERS 

If the input is through SYSIPT, you can switch back to SYSIPT as input device for 
specification of further parameters by entering IPT to the message: 

0V21D GIVE PARAMETERS 

Terminating the dump 

This can be done in any of the three ways given below: 

• Enter EOJ on SYSLOG. 

• Having a /* or a /& card at the end of the job stream when entering parameters 
through SYSIPT. 

• Pressing the END key in response to the message: 0V21D GIVE PARAMETERS 
after at least one address has been processed. 

Note: On Models 115 and 125 the END key is replaced by the ENTER key. 
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SYSVISDUMP 



When to execute the dump 

It is recommended to obtain a dump of SYSVIS whenever a stand-alone dump is 
executed. SYSVIS DUMP should be initiated just after the system re-IPL. To 
help your analysis of the information contained in the SYSVIS dump it is also 
recommended to execute a formatted stand-alone dump as described in A-3 of 
this Section. For this reason, execution of this utility is included in the flowchart 
A-3-F "Executing the Stand- Alone Dump". 



How to use the dump output 



During analysis of a system malfunction, such as a HARD WAIT STATE using a 
stand-alone dump output, it may be necessary to analyze the coding in a page 
belonging to a virtual partition which was not in real storage when the stand-alone 
dump was executed. 

The virtual address allocations can be obtained from the BOUNDARY BOX, and 
pages not in real storage can be found by analyzing the contents of the PAGE 
TABLE. The format and contents of the boundary box and the page table are 
described in Section 4, Chapter 1 2 of this manual. 

Therefore, the SYSVIS dump should be used in conjunction with the stand-alone 
dump output. It is recommended to always use a stand-alone dump generated with 
the DUMPGEN parameter FORMAT=YES. DUMPGEN is described in A-3 of 
this Section. 

It is essential that the operator save the copy of the PDS after executing the 
stand-alone dump. You as the system programmer, or the IBM CE/SE will then be 
able to print out all or any part of the PDS to complete problem analysis. 



'V>' 
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This program allows the operator to make changes to programs cataloged in a PDZAP 

system or private core image library. The program lists all changes on SYSLST. 
This printout should be retained as a record of changes made. 

System requirements 

PDZAP can be executed in any partition. Since PDZAP accesses a core image 
library, other programs rurming concurrently should not use the phases PDZAP 
is operating on in the same library. SYSLOG must be assigned to the operator 
console and SYSLST must be assigned to a printer. When card input is used, 
SYSIPT must be assigned to a card reader (hopper 1 on 5425/2560). 

Executing PDZAP 

The PDZAP program can be execured from the operator console or from a card 
reader. For cardless systems, input must be entered via SYSLOG. 

How to execute PDZAP from the operator console 

The following is an example in which the program PROG is used as a phase to be 
modified. 

— Call in the program 
// EXEC PDZAP 

— The system will respond on SYSLOG: 

4C861 IJBPDZAP REL. 34.0 program name and version 

4C99A ENTER YOUR NAME 

Type in your name, and the system wiU respond: 

4C85A ENTER PHASENAME (XCIL=XXXXXXXX) 

— Reply to this message in one of the following ways: 

a. if PROG is in the system core image library enter SCIL=PROG, or simply 
PROG, as SCIL is the default. 

b. if PROG is in the private core image library enter PCIL=PROG. 



When the phase is found, the following messages are issued: 

4C87I LOAD ADDRESS=xxxxxx 

4C88A ADDRESS XXXXXX,OFFSET+XXXXXX,SCAN=XX..XX,REF=XXXXXX 

Reply to this message in one of the following ways: 

• option 1 specify the hexadecimal address of the data you want 

displayed: 08072A 

• option 2 specify the offset to the reference point of the data you want 

displayed (the initial reference point is the load address): + 6D4 

• options specify a character string to be searched: SCAN='LABPROG 

• option 4 specify a hexadecimal string to be searched: 

SCAN=D3C1C2D7D9D6C7 

• options set a reference point: REF=08071C. 

If an address is invaUd or a string cannot be found, an error message will be issued. 
To options 3 and 4 the system will first respond with: 

4C94I SCAN ADDRESS xxxxxx 

Options 1-4 wiQ result in the display of up to 16 bytes of data in the format 

4C89D XXXX...XX cccc.cc 

where x..x is the hexadecimal representation and c.c is the corresponding 

character representation. 

The data printed is contained in a single library block. If less than 16 bytes are 

displayed, it is either the end of the program or the end of the library block. 
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PDZAP 



If only a display is wanted, press END/ENTER. 

To modify the displayed data, type in replacement data for the number of 
bytes to be changed. For instance, if the data displayed is: 

4C89D 

05B012110746410000014790B42807F6 6 

to change the first four bytes to NOP, type in: 

07000700 

- The system will respond with message 4C88A again and you can use one of 
the five options mentioned above to display or modify another portion of 
the same phase, or to set another reference point. 

- If you are finished with this phase, but want to access another phase, use 

• option 6 terminate processing with this phase by typing 

END PHASE 

Now the program repeats message 4C85A, which allows you to specify the 
name of another phase. 

If you want to terminate the execution of PDZAP, use 

• option 7 end PDZAP operation by typing: END 

How to execute PDZAP from a card reader 

Executing PDZAP from SYSIPT is the same as from SYSLOG, with the following 
exceptions: 

- // UPSI 1 must be specified to indicate card input 

- data must be verified before it can be changed. 



4 
1.. 






Example: 

// UPSI 1 
// EXEC PDZAP 

NAME=your-name 

SCIL=PROG 
+ 6D4 

VER=05B0,1211 
or VER=05B01211 

REP=07000700 
or REP=0700,0700 

END 



indicate card input 

call the program 

Specify your name. If this is invalid or omitted, 

PDZAP will prompt you via SYSLOG. 

specify the phase to be accessed 

specifies the position of the dkta to be displayed 

(option 2) 

specifies the data to be verified; if the data is not 

found, no update will take place 

specifies the data which is to replace the data just 

verified 

terminates the run. 



The format of the VER and REP data can be: 

- a hexadecimal string (full bytes, or an even number of digits) 

- a set of 2-byte entries, separated by commas 

- a character string, preceded by a quote (VER='LABPROG). 
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Output on SYLST: 

At the start of execution, the program prints: 
PDZAP 

Date and time of the change 
Your name 

After this, the program prints the following information for each code change: 
Name of the phase changed 
Load address of the phase 
Address of the change 
Old and new data in hexadecimal. 



Library Display Programs and Utilities 

PDZAP 
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COPY FILE AND MAINTAIN 
OBJECT MODULE 
(OBJMAINT) 



This system utility serves multiple purposes: 

• File-to-file copying for card and card image files on tape, diskette, or sequential 
disk with blocking/deblocking. 

• Update of relocatable and core image library object programs using user REP 
statements and IBM PTFs via tape, diskette, or sequential disk. 

• Expansion/truncation of object modules 

Selection/exclusion of FTP jobs to be copied prior to FTP application. 

• Comprehensive listing of files, SYSIN jobstreams and object modules. 

This section addresses the use of OBJMAINT for the maintenance of object 
programs with both IBM FTPs and user REF statements. The 'DOS/VS Maintain 
System History' program may be used to store appUed FTFs in a history file. 
For a detailed description of the use of these programs, refer to 'DOS/VS System 
Utilities'. 






Input/output 

Input consists of: 

• OBJMAINT control statements on SYSIFT 

• data file, object module, or FTP jobs on SYS004. 

Output consists of: ^ 

• printout of OBJMAINT control statements, messages, statistics and 
requested ./ LIST data on SYSLST 

• data file, updated object module, or selected FTPs in blocked/unblocked 
or SYSIN format on SYS005 

• console messages. 



Function/control statements 

The control statements used to define an OBJMAINT run are shown in the table 
below. One group 2 control statement (which defines the function for execution) 
must follow one or more group 1 statements. Exception: the ./ SELECT or 
,/ LIST may be used alone when the input file is not or a card device. If the 
./ LIST input is cards, then the ./ END statement must be used if no other group 
2 statement is used. 



\,._ 
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1 

Description 


Group 1: 

ACTION 


Input characteristics; for example, source of input, multiple 


volumes 


BLOCK 


Physical record sizes of tape or disk output 




CARD 


Specifies alternate EOF delimiter for card input 




EXCLUDE 


Indicates jobs to be excluded from processing 




EXIT 


User phase to process each input record read 




LIST 


Selective listing and formatting of input data 




SELECT 


Indicates specific jobs to be processed be OBJMAINT 




UNREP* 


Allows removal of previously added user REP statements 




Group 2: 
COPY 


File-to-file copy with deblocked output (BLOCK overrides) 




DEBLOCK 


File-to-file copy with deblocked output 




END 


Delimits card input during a list only function 




EXPAND * 


Expands or truncates a control section (CSECT) 




EXPAND/REP * 


Single statement combines EXPAND and REP functions 




REP* 


Allows updating object module via user REP statements 
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COPY FILE AND MAINTAIN 
OBJECT MODULE 
(OBJMAINT) 






These statements may be used only for the maintenance of object programs and PTFs. 
All group 2 statements, except END, cause the SYS005 file to be created. 



How to use 

In order to update a cataloged object program with user REP statements or 
IBM PTFs, tlie following three steps (as shown in the figure below) are required: 

• using RSERV or CSERV, punch the required module to tape, diskette, 
or disk 

• execute OBJMAINT with SYS004 input to do any of the following 

- expand /truncate the size of the object module 

- eliminate previously applied PTFs or user REP statements 

- add new user REP statements 

- select/exclude PTF jobs to be copied to SYS005 

- deblock the input to create SYSIN data on SYS005 

• execute LNKEDT or MAINT to catalog the updated object module to 
the core image library or the relocatable library respectively. 
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COPY FILE AND MAINTAIN 
OBJECT MODULE 
(OBJMAINT) 



RSERV 



SYSPCH 




~X, 



_/' 



RELOCA- 
TABLE 
LIBRARY 



SYS005 



or 



OBJMAINT 




or 




SYS004 



SYS005 



RELOCA- 
TABLE 
LIBRARY 




\___^,/ 



MAIIMT 



The above figure shows the steps involved in maintaining relocatable object 
modules, using user REP statements and IBM PTFs. 

The examples that follow illustrate the use of OBJMAINT with PTFs and user 
REP statements. 



/^^ 
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Example 1. COPY FILE AND MAINTAIN 

The following job deblocks and selects one DOS/VS PTF job from the IBM PTF OBJECT MODULE 

distribution tape and creates a SYSIN job stream on diskette. Any non-object (OBJMAI NT) 

module statements will not be printed on SYSLST. The last job step will print 
the selected PTF job . 

// JOB PTFSLECT 

/ / DLBL UOUT , ' PTFWORK 3 ' , 7 5 / 3 00 , DU 

// EXTENT SYS005,0BJMNT 

// ASSGN SYS004,X'283' 

// MTC REW,SYS004 

// ASSG SYS005,3540 

// EXEC PGM=OBJMAINT 

./ LIST PARM=LIMIT 

./ ACTION JOBTYPE=DOS 

./ SELECT N02748#3 

./ DEBLOCK FOR SYSIN 

/* 

// PAUSE START DISKETTE FOR SECOND TIME 

// MTC REW,SYS004 

// RESET SYS005 

// DLBL UIN, 'PTFW0RK3' , ,DU 

// ASSGN SYS004,3 540 

// EXEC OBJMAINT 

./ LIST 

/* 

/& 



B 
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COPY Fl LE AND MAINTAIN Example 2. 

OBJECT MODULE The job below performs the three steps involved in updating an object module (j \ 

(OBJMAI NT) ^^^^ *^® relocatable library. The module, OBJTEST, is punched out to disk, ^ - 

becoming input to OBJMAINT. Previously added user REP statements are 
removed, before adding new ones. Each object module TXT statement will be 
printed on one line in character only format. The object module is recataloged, 
then Usted on SYSLST. 

// JOB UPDTMOD 

// DLBL US YSPH, 'PTF. WORK. FILE. 1 ' ,0,SD 
// EXTENT SYSPCH,CPMDY5, , ,5681 ,38 
// ASSGN SYSPCH,X'130' ,PERM,V0L=CPMDY5,SHR 
// EXEC RSERV 
PUNCH OBJTEST 

/* 

CLOSE SYSPCH,X'OOD' 

// DLBL UIN, 'PTF.WORK.FILE.I ' ,0,SD 
// EXTENT SYS004,CPMDY5 

// ASSGN SYS004,3330,TEMP,VOL=CPMDY5,SHR 
// ASSGN SYS005,X'281 ' 
// MTC REW,SYS005 
// MTC WTM,SYS005 
// MTC REW,SYS005 
// EXEC OBJMAINT 
./ LIST PARM=SHORTTXT 
./ UNREP 

./ REP NM=0BJTEST,SD=(001) 
f REP 000010 001FFFF,FFFF,FFFF,FFFF,FFFF,FFFF,FFFF,FFFF ^ ^ 

/* 'V -^ 

// MTC REW,SYS005 

// RESET SYS005 

// ASSGN SYSIPT,X'281 • 

// EXEC MAINT 

// MTC REW,SYSIPT 

// RESET SYSIPT 

// EXEC RSERV 

DSPLY OBJTEST 
/* 
/& 



2.146 Serviceability Aids 



Section 2-D 

CONTENTS 



Aids provided by the Operator's Console 



ALTER/DISPLAY feature (all Models) 2.148 

When to use (all Models) 2.148 

How to use (Models 135, 138, 145, 148 and 155-11) 2.148 

Operator's flowchart 2.151 

Format of output 2.152 

Error messages 2.153 

How to use (Models 115 and 125) 2.155 

Operator's flowchart 2.157 

Format of displays and error indications 2.158 

How to use (Model 158) 2.160 

Operator's flowchart 2.161 

Instruction stepping 2.162 

When to use (all Models) 2.162 

How to use (Models 135, 138, 145, 148 and 155-11) 2.162 

Operator's flowchart 2.163 

How to use (Models 115 and 125) 2.164 

Operator's flowchart 2.165 

How to use (Model 158) 2.166 

Operator's flowchart , 2.167 

Stop on address compare 2.168 

When to use (all Models) 2.168 

How to use (Models 135, 138, 145, 148 and 155-11) 2.168 

Operator's flowchart 2.169 

Howtouse(Modelsll5andl25) : 2.172 

Operator's flowchart 2.173 

How to use (Model 158) 2.174 

Operator's flowchart 2.175 

Console dump operation (Models 115 and 125) 2.176 

How to use 2.176 

When to use 2.176 

Operator's flowchart 2.177 

Store Status and Clear Real Storage 

Store status 2.178 

Models 135, 145 and 155-11 2.178 

Models 138 and 148 2.178 

Models 1 15 and 125 2.178 

Model 158 2.178 

Clear real storage 2.179 

Models 135, 138, 145, 148 and 155-11 2.179 

Models 115 and 125 2.179 

Model 158 2.179 

When to use 2.179 

Save usage counters 2.180 

Models 1 15 and 125 only 2.180 



Serviceability Aids 2. 1 47 



Aids provided by the Operator's Console 



ALTER/DISPLAY 
FEATURE (ALL MODELS) 



The ALTER/DISPLAY facility allows the operator to dump or display, and 
change the contents of various parts of the CPU storage (depending on the CPU 
Model) and of real or virtual storage. 

For the purpose of hands-on debugging, the following areas may need to 
be displayed: 

Any selected area of virtual storage 
General registers 
Floating-point registers 
Current PSW 
Control registers 



{ 



Note: This facihty is provided only on the console devices native to the CPU. 
It is not available, for example, on IBM 3277 devices used as consoles. 

When to use 

ALTER/DISPLAY is useful for hands-on debugging, and enables the operator to 
obtain information about the system at the time a malfunction occurs. It must 
be used whenever a display of the low address storage is required, for example, 
to record a wait state message (see E-3 in this section). 

Flowcharts in section 3 indicate when to use this facility, and which option to 
choose for a particular system malfunction 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 

How to use this feature 



Vii — y *-- - ■ -^ Vinii.i ■— / *- ■ II* ^ ■* '^ -^ ^ ■* >■■ ■- !-• Vi ■.I.I.I I -V V.II. — ■ 1../ v« ■• V i.i. - -■/ v .1/ > II i,„,^ 
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PF10 


PF11 
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Model 138/148 Display Console Keyboard. 
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Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 135, 138, 
145, 148, 155-11 







CANCEL 


INTVN 
REQD 










NOT 
READY 




READY 












ALTER/ 
DISPLAY 


ALT/DISP 
MODE 









RETURN 



QQQQQQEDQEimd] 



PROCEED 



SHIFT 



SHIFT 




[ 



Spacebar 



o 



► 



Indicator 


Condition 


INTVN 
REQD 


The console printer is out of forms or the 
PR-KB is not ready. 


ALT/DISP 
MODE 


A request for an alter/display operation was 
accepted. 


ALARM 


An alarm command was issued, and manual 
intervention is required by the operator. 


PROCEED 


The PR-KB is unlocked and ready to accept 
characters. This indicator is turned on by the 
ALTER/DISPLAY key or by a read command. 


REQUEST 
PENDING 


A request operation was initiated. The indicator 
is turned off when the attention status is 
accepted by the CPU. 



Indicator 



► 
► 



Key 


Function 


NOT READY 


Places the console printer in a not-ready condition. 


CANCEL 


Used to terminate a read command when the operator has 
made an error in data entry. Normally, the program will 
issue the same read command again. 


READY 


Places the PR-KB in the ready state when forms are in the 
printer and the cover is closed. 


ALTER/ 
DISPLAY 


Requests or ends an alter/display operation. When used to 
end an alter/display operation, the PR-KB remains in alter 
/display mode. 


END 


Terminates a read, write, or alter/display operation. 


ALARM 
RESET 


Resets the ALARM indicator. 


REQUEST 


Initiates the attention routine to enable operator/ 
system communication 



Key 



Indicators and Control Keys (3210 and 3215 printer keyboard) 
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Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 135, 138, 
145, 148, 155-11 



,> 



Table D-1 below summarizes the ALTER/DISPLAY options that can be selected 
when using the flowchart shown in D - 1 -F, 



Mnemonic 


Storage 
Area 


Address Range 


Alter 


Display 


AM 


DM 


Real address area 


000000-03BFFF1 


AV 


DV 


Virtual address area 


000000-1 6 megabytes 


2 


DS 


Control storage 


0000-DFFE'''^ 


AG 


DG 


General register 


0-F 


AF 


DF 


Floating-point register 


0,2,4,6 


AP 


DP 


PSW 


None 


AC 


DC 


Control register 


0-F 


AK 


DK 


Storage key 


000000-03BFFF'' 


AX 


DX 


Transmission speed'* 


1—8 (line number) 



Notes: 



Use address length shown; if necessary, fill-up with leading zeros. 



4. 



Model-dependent. 

You cannot alter control storage data. 

Control storage addresses are not continous. For control storage address to be 

valid, leftmost (fourth-highest) digit must be: 

1. For 24K control storage size: 0—5 

2. For 36K control storage size: 0-5, 8. A, or D(hex) 

3. For 48K control storage size: 0-5 or 8-D(hex) 

Line speed can only be changed if, with your ICA feature, you have the SDA 
II subfeature with clocking provided by the Model 135. 
= 600 bits per second, 1 = 1200 bits per second. 



v.,./ 



Table D-1. Options for the ALTER/DISPLAY feature. 



Notes: When the operation is ended with the ALTER/DISPLA Y key (MODE 
SEL on Models 138 and 148), the keyboard remains in ALTER/DISPLA Y 
mode (ALT/DISP MODE indicator on). When the operation is terminated 
with the END/ENTER key, ALTER/DISPLA Y mode is terminated 

For ALTER/DISPLA Y of general and floating-point registers, a wraparound is 
performed (F to for general registers, and 6 to for floating-point registers). 
When addressing virtual storage, either a word or byte address may be used. 
If the starting address is not on a word boundary, the console printer /display 
console spaces and aligns at the byte addressed. 



y 
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Aids provided by the Operator's Console 







Yes 



Start 



Press STOP and wait until 
MAN indicator turns on 



Printer keyboard: 
Press ALTER/DISPLAY 
and wait until PROCEED 
lamp lights. 

Model 138/1 48 console: 
Press MODE SEL key. 



ds: 



Type two-character 
mnemonic and hex address 



Specifies; 

1. Alter or display 

2. Storage area 

3. Address in virtual storage 
See tabel D-1 

for choice of options. 



Model 138 or 148: 
Press ENTER 




No 



Type hex data to alter 
information as required. 
(See "Format of Printout. 




Console displays or 
prints requested data 
(see "Format of Output"). 



Press END (printer- 
keyboard) or ENTER 
(Model 1 38/1 48 console) 



To resume processing 
press START 



ALTER/DISPLAY 
MODELS 135, 138, 
145, 148, 155-11 



D-1-F 



Carriage return and line feed occurs. 
ALT/DISP MODE indicator turns on. 
Model 138 or 148: Current screen 
contents are saved and replaced by 
the Alter/Display frame. 



Data may be entered, one digit at a 
time, using the space bar to skip over 
positions not being altered. The data 
in the skipped-over positions remains 
unchanged and is printed out (displayed) 
each time the space bar is operated. To 
end the operation, press the END/ENTER 
or the ALTER/DISPLAY (MOD SEL) 
key. 



Data is printed starting at the address 
specified and continued until the 
END or the ALTER/DISPLAY key is 
pressed. (Contents of locations or 
registers are not affected.) 

Model 1 38 or 1 48: 

128 bytes are displayed starting at the 

address specified. 



Line feed occurs; ALT/DISP MODE 
indicator turns off; system is in the 
manual state. 

Model 138 or 148: Original screen 
contents are restored. 
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ALTER/DISPLAY 
MODELS 135, 138, 
145, 148, 155-11 



Format of output 

Starting at the specified address, the requested data are printed or displayed 
in groups of eight characters with up to eight groups per line. Depending on 
your starting address, the initial group might not contain eight characters. 
When general and floating-point registers are displayed, the address sequence 
'wraps', that is, the highest available address is followed by the lowest address 
(zero). 

When altering, enter new hex characters in the positions occupied by the characters 
to be replaced. Reach the required positions by repeating characters to be 
retained. On the Model 138/148 Display Console, the space bar may be used to 
skip over characters which are not to be changed. 

Examples are shown below of the printout (reduced in size) from a 3215 console 
printer by using the ALTER/DISPLAY feature. The output on the Model 138/148 
Display Console has a similar format. The contents of the screen can be printed 
by pressing the PF5 key. 






Example 1 

This example shows a display of the 

• current PSW (DP) 

• general purpose registers (DG) 



control registers and 
low address storage. 



.l\k 

O74D00OO 

.JiC 

004000FF 
..QM.QEEEE 

.1)0 

00089A7C 
..0.008.9.9.7.8 

..DM....0OO.OO0.. 

00000000 
.0.7..4lJ.Q0.0.a 

4000E6F0 
..0.4.OC.UO0O 

00000540 
..0.000.0.0.00 

00000000 
.0.000.000.0 

00000000 
..0.000.0.00.0 

00000000 
..0.0O0.0.0.0O 

00000000 



000B9ABC 



0000E640 
fiOQ.O.OO.O.0. 



00089E80 
.000a9£80.. 



00000000 
O0Oa9.BA2.. 

ocoooooo 
oo.o.ao.t!cc.. 

00000000 
.00.000000. 
00000000 
OO0.O0O00.. 
00000000 
.00.000000. 
WW)0000 
.00000.000.. 
00000000 



FFFFFFFF 
..O.QOQ.OOQO. 



00089E78 
..0O.09E4.4.7.. 



00000000 
.0.40.CO0OO. 

400070B8 
.0O0.CO00O. 

00020007 
.200000.60.. 

00000000 
.000.00000.. 

00000000 
.0.00.000.00.. 

00000000 
.000000.00.. 

00000000 



FFFFFFFF 

oooooooo. 



00089eAC 
. 4.00a9F.SA.. 



00000000 
.000009112.. 
OOOOOOOO 

..o.ooo.A.5ric. 

00040000 

..oooao.2co. 

OOOOOOOO 
..OOOOOOOO.. 

OOOOOOOO 
..OOOOOOOO.. 

OOOOOOOO 
..OOOOOOOO. 

OOOOOOOO 



OOOOOOOO 
000.00000 



00089E80 
.400.8AD9A 



OOOOOOOO 
OOOOOOOO. 

oAoaoooo 

4009D840 
.000.00000.. 
OOOOOOOO 
..OOOOOOOO. 
OOOOOOOO 
.000.00000.. 
OOOOOOOO 
..OOOOOOOO.. 
OOOOOOOO 



OOOOOOOO 
OOOOOOOO.. 



00000019 
. 0.00892EX>.. 



00004450 

OOOOOOOO.. 

020AFE5B 

.0.000.D.1.3A. 

00020000 

OOOOOOOO 
..OOOOOOOX).. 

OOOOOOOO 
.0.000.000.0.. 

OOOOOOOO 
.0.000.000.0. 

OOOOOOOO 



OOOOOOOO 
..C20.00000. 



A0089EI1C 
.80.089.EFO 



OOOOOOOO 

O7.0F20OO. 

040C0000 
.O4.0C04iO0. 

OOOOOOOO 
..OOOOOlj^O, 

OOOOOOOO 
• OOOOOOOO. 

OOOOOOOO 
..OOOOOOOO 

OOOOOOOO 
■ OOOOOOOO.. 



OOOOOOOO 
.00000200.. 



0008A157 
0OO89MO. 



OOOOOOOO 
..0000090C 

000GOCi4 

OOOOORIO. 

OOOOOiCC 
• OOOOOOOO-. 

OOOOOOOO 
•••OOOOOOOO- 

OOOOOOOO 
..^•OOOOOOO- 

OOOOOOOO 
•OOOOOOOO 



'V-.-/ 



(ifjr^n 



Example 2 

In this example, the contents of control registers 9, 10, and 1 1 were altered. First 
the operator displayed the contents by using the DC option. Then using the AC 
option, he entered the new data. To ensure that the data change was successful, 
the operator has displayed the control registers again. 









■MHaMMM 


■MMMMHHI 


■MMMMM 


■■■■■IMjHj 




■HHHHHH| 










^^^^ 


^^^^ 


^^^^ 


^^^^ 




^^^^ 


004000FF H 
OOOOEOOO H 


• 


Df, 9 
' OF12iLiOO 

■;■ OOOOEA'40'' 


OOOOOOOO 

l^FFFFrFF"' 


oooooooo 

Tfffffff 


OOOOOOOO 
0000<)000 


OOOOOOOO 
OOOOOOOO 


C2000000 
OOOOOOOO 


00000200 
OOOOOOOO 




■;■ sc'^ 

; OOOOOOAA 


AA8<^3(>0 


riEFi2301 










■ 


........... 


1 DC 9 

T ooooiOOAA 

! 0000E&40 

•T 

1 














■ 


..FFFFFFFF 


DEF12301 

....F.F.F.FF.FFF.. 


OOOOOOOO 

ooppopoo 


OOOOOOOO 

pppppppp 


C2000000 

ppoppppp 


00000200 

pppppppp 


664666FF H 

OOOOEOOO ■■ 








HHHI 


HBlii 


HHHl 


■■■1 




HHHl 


■■■■■■■I 
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Error Messages 

An ALTER/DISPLAY operation is terminated when an ALTER/DISPLAY error 
message occurs or when the end of a storage area or register is reached. 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 135, 138, 
145, 148, 155-11 



Model 135/138 Alter/Display Error 

Invalid character: An invalid character is created when you use the mnemonic not 
shown in the table, when you address a feature not installed on your system, or 
when you enter an address or data character that is not a hex digit. An invalid 
character is ignored (no print or space occurs). Continue by entering the correct 
character— it is not necessary to restart the whole operation. 




Invalid address: An invalid address is created when your address is not addressable 
location (the address might be outside the storage capacity of your system or you 
may be trying to address a virtual address that is not in the real address area) or 
when you address an ICA line either not installed or not fitted with the SDA II 
subfeature with clocking by the Model 135/138. An invahd address terminates 
the operation with the message '? ADR.' You must start again. 



o 



Invahd Data: When changing the transmission speed for a communications link 
(AX or DX mnemonics), the only vahd data characters are '0' or '1 .' When any 
other hex character is entered, the operation is terminated with the message 
'?DATA.' The transmission speed remains unaltered. 

Invalid-Format PSW: When you enter an invalid-format PSW, the PSW is altered 
but an interruption is generated when the invalid PSW is subsequently used. 



Model 145/148 Alter/Display Error 

Invahd Character: INVAL CHAR is printed if one of the following occurs: 

• The first character of a mnemonic is not A, D, or T (see Keyboard Test 
Mode Operation). 

• The second character is not M, S, L, K, C, 6, F, or P. S and L are reserved 
for service personnel, 

• An invalid digit is typed when addressing or altering data. 

• The CANCEL key is pressed. 

Invalid Address: INVAL ADDR is printed if one of the following errors occurs: 

• Invalid starting address. 

• The updated address exceeds the capacity of specified storage. 

• The operator performs an AS or AL operation. 

• You may be trying to address a virtual address that is not in the real 
address area. 



Model 155-11 

As a result of the editing function, the following indications are given: 

1. If an invalid character is detected in the op code, storage mnemonic, or hex digit 
(0-9 and A-F), the printer does not respond. The operator can then key in the 
correct character. 

2. If an invalid address (beyond the physical storage) is detected the error message '?' 
is printed. 

3. If an alter PSW operation is invalid, the PSW is restored to its original value 
and '?' is printed. 
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Aids provided by the Operator's Console 



ALTER/DISPLAY 
MODELS 115 AND 125 



The ALTER/DISPLAY facility allows the operator to display or change the 
contents of the following parts of the CPU (Central Processing Unit), and of 
eal virtual storage areas: 

General registers 
Floating-point registers 
Current PSW 
Control registers 
Protection keys 
Real storage areas 
Virtual storage areas. 



i 



..J 



A "hard copy" of all information displayed on SYSLOG can be obtained on a 
Model 115 and 125 with a 5213 printer attached by pressing the COPY key 
after the information is displayed. 

CAUTION 

The effect on the operation of programs currently running in the system that are 
time dependent, for example, a program using MICR or teleprocessing as input/ 
output, must be considered before using this serviceability aid. 



\y 
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Aids provided by the Operator's Console 



How to use 



ALTER/DISPLAY 
MODELS 115 AND 125 



Before the ALTER/DISPLAY feature can be used, the mode select display shown 
below must be brought to the screen by pressing the MODE SELECT key. 



MODE SELECTION 



o 



R SYSTEM RESET 

C ADDRESS COMPARE 

L PROGRAM LOAD 

T INTERVAL TIMER 

K CHECK-CONTROL 

D STORAGE DUMP 

E ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

1 INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 




To select the ALTER/DISPLAY feature: 

1 . Type A into the mode select display. 

2. Press the ENTER key. 

The ALTER/DISPLAY picture as shown below is brought to the screen and 
shows those parts of the CPU and real/virtual address areas that can be altered 
and/or displayed. 



♦ ALTER/DISPLAY * 

G GENERAL REGISTERS 

C CONTROL REGISTERS 

P CURRENT PSW 

F FLOATINGPOINT REGISTERS STORAGE ADDRESS 

K PROTECTION KEY 000000 - FFFFFF 

M MAIN STORAGE REAL 000000 - FFFFFF 

V MAIN STORAGE VIRTUAL 000000- FFFFFF 



MODE SPECIFICATION: 



To select a particular display: 

1. Type in the associated mnemonic according to the instruction given in the 
next flowchart. 

2. Press the ENTER key. 

Before ENTER is pressed, you can still change your input by using the cursor 
keys and entering the changes in the usual way. As soon as ENTER is pressed, 
the new data replaces the old. The display remains on the screen and the 
cursor is at the next ALTER/DISPLAY line. Because there is an A (for 
ALTER/DISPLAY on this line, you need only enter F (for floating point 
registers) or P (for PSW), and so on. 
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Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



G 

GENERAL 

REGISTERS 


To display: 

1 . Type G into the alter/display picture. 

2. Press ENTER. 

All general registers appear at once. 


F 

FLOATING- 
POINT 
REGISTERS 


To display: 

1. Type F into the alter/display picture. 

2. Press ENTER. 

All floating-point registers appear at once. 


P 

CURRENT PSW 


To display: 

1 . Type P into the alter/display picture. 

2. Press ENTER. 

The current PSW is displayed in binary notation, except for the 
instruction address, which is in hex. BO or EC mode is indicated in the 
machine status area, line 14, and in the E-bit in the PSW. 

o BC Mode: The system is in basic control mode when the E-bit 

is zero. 
EC Mode: The system is in extended control mode when the E -bit 
isl. 


C 

CONTROL 

REGISTERS 


To display: 

1 . Type C into the alter /display picture. 

2. Press ENTER. 

All control registers appear at once. 


K 

PROTECTION 

KEY 


To display: 

1 . Type K into the alter /display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

In the protection key display: 
o The address is in hex. 
o The key is in binary. 

The reference (R), the change (C), and the protection (P) bits 
are in binary. 


M 

MAIN 
STORAGE 
REAL 


To display: 

1 . Type M into the alter/display picture. 

2. Type in the main storage address in hex. 

3. Press ENTER. 

The display shows 32 halfwords of main storage at once. The first 
column in the format illustration represents, in hex, the main 
storage address without its low-order digit. The missing low order 
digit of the address is shown above each leftmost byte of each halfword. 


V 

MAIN 
STORAGE 
VIRTUAL 


To display: 

1 . Type V into the alter/display picture. 

2. Type in the address. 

3. Press ENTER. 

The display shows 32 halfwords of main storage at once. The first 

column in the format illustration represents, in hex, the main 

storage address without its low-order digit. The missing low order 

digit of the address is shown above each leftmost byte of each 

halfword. 

The first address (after the word REAL) is the real address of the 

first byte (without the last digit). 






V...,.--f 



Examples following the flowchart opposite show the tormat of the various 
displays and describe error indications where applicable. 



Table D-2 Options for the ALTER/DISPLAY console feature 
(Models 115 and 125) 



J 
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Press MODE SELECT 



Type in A and press 
ENTER 






Specify the display 
required by typing in the 
associated mnemonic 



Press ENTER 



Figure D-2 parts 1 and 2, 
illustrate the displays asso- 
ciated wifith the mnemonics, 
and desCTibe error indica- 
tions wheira applicable. 



NO 



Make a note of the required 
instruction address and 
contents displayed. 




To alter any of the dis- 
played contents, move the 
cursor under the first digit 
and type in the new data. 




Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 



If you have a display, selected from the 
Alter/Display set or other service function, 
and then press MODE SELECT, the 
Alter/Display picture will appear. To get 
the mode select picture you have to press 
MODE SELECT twice. 



Refer to the list of mnemonics and 
instructions given on the opposite 
page. 



D-2-F 



The first digit can be hexadecimal 
or binary, depending on the display 
specified. The new contents appears 
on the line below the original until 
the ENTER key is pressed. 



The original display is replaced to 
display the new contents. 



The last picture of the operating 
system is brought back to the screen. 
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ALTER/DISPLAY 
MODELS 115 AND 125 



Error messages 

If logical errors are made while altering 

the current PSW, one or any of the 

following error indications may be 

displayed: 

1. EC-PSW ERROR 

2. INVALID ADDRESS LOADED 

3. ADDRESS NOT TRANSLATE- 
ABLE 

Message 1 indicates PSW rejection, 
which is caused if bit 1 2 of the PSW 
is set to zero. Messages 2 and 3 
indicate that the PSW has been loaded, 
but a program check will occur when 
an attempt is made to continue 
operation. 

Message 3 occurs in case of invalid 
page or segment table address 
specification exception. 



Format of displays and error indications 

The following illustrations show the amount and format of information displayed 
with the associated mnemonic. When a wrong character (either a non-hex or a non- 
binary as the case may be) is entered, INVALID CHARACTER appears. The 
cursor marks the first invalid character. 



G GENERAL REGISTERS 



ALTER/DISPLAY GENERAL REGISTERS (HEXADECIMAL) * 



0000 0000 1 0000 0000 2 0000 0000 3 0000 0000 
4 0000 OO'OO 5 OOdoToOO 6 0000 0000 7 0000 0000 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 



C 0000 0000 D 0000 0000 E 0000 0000 F 0000 0000 



NEXT ALTER/DISPLAY: A 



,4^'\ 



\_ _j 



FLOATING POINT REGISTERS 



* ALTER/DISPLAY FLOATING POINT REGISTERS (HEX) 



0000 0000 0000 0000 



\ ./ 



2 0000 0000 0000 0000 



4 0000 0000 0000 0000 



6 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Current PSW 



ALTER/DISPLAY CURRENT PSW 



SYST.MASK KEY 

0000 0000 0000 



EMWP ILC CC 

0000 00 00 



PROGRMASK 



INSTRUCTION ADDRESS: 000000 
ADDRESS IN HEX, OTHER DATA IN BINARY 



NEXT ALTER/DISPLAY: A 



./ 



Figure D-2,part 1 of 2. Format of the displays for Models 115 and 125. 



2.158 Serviceability Aids 



CONTROL REGISTERS 



ALTER/DISPLAY CONTROL REGISTERS (HEXADECIMAL) 



0000 OOEO 1 0000 0000 3 FFFF FFFF 3 FFFF FFFF 

4 0000 0000 5 0000 0000 6 0000 0000 7 0000 0000 



8 0000 0000 9 0000 0000 A 0000 0000 B 0000 0000 

C 0000 0000 D 0000 0000 E 0200 0000 F 0000 0200 



NEXT ALTER/DiSPLAY; A 



K PROTECTION KEY 



Aids provided by the Operator's Console 

ALTER/DISPLAY 
MODELS 115 AND 125 




ALTER/DISPLAY PROTECTION KEY 



ADDRESS: 00002F KEY: 00( 



NEXT ALTER/DISPLAY: A 



Error messages 

INVALID ADDRESS appears if the address 
is larger than the real storage size. 

The address has to be typed in with leading 
zeros. When selecting the alter /display 
protection key display, do not use any 
commas or blanks. 



o 



M MAIN STORAGE REAL 



* ALTER/DISPLAY MA!N STORAGE REAL (HEXADECIMAL) » 

2468ACE 

00012 0000 0000 0000 0000 0000 0000 0000 0000 

00013 0000 0000 0000 0000 0000 0000 0000 0000 

00014 0000 0000 0000 0000 0000 0000 0000 0000 

00015 0000 0000 0000 0000 0000 0000 0000 0000 

NEXT ALTER/DISPLAY: A 



V ALTER/DISPLAY MAIN STORAGE VIRTUAL 



ALTER/DISPLAY MAIN STORAGE VIRTUAL (HEX) 



REAL; 03E28 2 4 



SAC 



51A94 D0E3 AB13 5478 4ABE 0000 0000 0000 0000 



61A95 0000 0000 0000 0000 0000 0000 0000 0000 



61A96 0000 0000 0000 0000 0000 0000 0000 0000 



61A97 0000 0000 0000 0000 0000 0000 0000 0000 



NEXT ALTER/DISPLAY: A 



Error messages 

If the contents of the virtual address 
entered is not in real storage the 
virtual storage area will not be 
displayed. Instead one of the following 
messages will be displayed: 
OUTSIDE PAGE TABLE 
OUTSIDE SEGMENT TABLE 
PAGE ENTRY INVALID 
SEGMENT ENTRY INVALID 
SPECIFICATION EXCEPTION 
ADDRESSING EXCEPTION 



Figure D-2, part 2 of 2. Format of the displays for Models 115 and 125 
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ALTER/DISPLAY 
MODEL 158 



The ALTER/DISPLAY facility allows the operator to display or change the 
contents of the following parts of the GPU (Central Processing Unit), and of real 
or virtual storage areas: 



General registers 
Floating-point registers 
Current PSW 
Control registers 
Protection keys 
Real storage areas 
Virtual storage areas 



Rial Channel UCWs 
Logical Channel UCWs 
Active UCWs 
CPU Local Storage 
I/O UCW Local Storage 
I/O Buffer Local Storage 






How to use 

The ALTER/DISPLAY frame, shown below, can be entered only from the 
MANUAL or SERVICE frame when the CPU is in the stopped (manual) state. 




A procedure for using this facility is shown in the flowchart on the opposite page. 

Error Indications 

All address characters are checked as they are entered for hex values 0-F. 
Invalid characters are not displayed and the console alarm sounds. 

If the cursor stays in the reset position (under the Y in Key In/ Address) and if the 
console alarm sounds, an invaUd function code has been entered. A valid function 
code must be entered before the cursor will reposition to the right (one position). 

Printing displayed information 

A "hard copy" of all information displayed can be obtained on a Model 158 with 
a 3213 printer attached by pressing the COPY key after the inforrnation is displayed. 
Note however, that the following frames cannot be printed: 

• PROGRAM 

• ALTER/DISPLAY 

• INDEX 

(and when using the ALTER facility, only lines that have been changed by entering 

new data will be printed on the 3213 printer.) 

CAUTION 

The effect on the operation of programs currently running in the system that are 

time dependent, for example a program using MICR or teleprocessing as input/ 

output, must be considered before using this serviceability aid. 
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Aids provided by the Operator's console 



G> 



^%^i^ 



If the function requires 
an address the cursor ■ 

nnoves to the first digit 
under KEY IIM/ADDRESS 
(see the note below) 

The cursor moves to , .^s 
the right until the C-.-; t^-' 
address is complete ~ - 

The cursor will pos- 
ition itself under the 
first digit of the con- 
tents of the location 
at the specified address \~ 

The cursor will pos- 
ition itself at the next ■ ' 
digit that can be altered. 



';> 



Press STOP, 

then 

Press MODE SEL 



■'■r^^. 



ALTER /DISPLAY 
MODEL 15a 



Type in F3, or press 
light pen to lozenge. 
3-ALTER/DISPLAY 



ALTER 




t?TThe MANUAL frame will be 
~ '^displayed 

The ALTER/DISPLAY frame 
will be displayed as shown on 
the opposite page 



DISPLAY 



Type in A or press 

light pen to lozenge 

■ A-ENABLE ALTER 



Type in the associated 
mnemonic for the 
function to be altered, or 
use the light pen. 



Type in an address or 
use the light pen 



Press ENTER or COPY, 
or use light pen 



Type in new data or 
use the light pen. 



Press ENTER, or COPY, 
or use light pen. 



Yes 



Type in D or press 
tight pen to lozenge 
■ D-D I SPLAY 



Type in the associated 
mnemonic for the 
function to be dis- 
played, or use the 
light pen. 



If locations are to be 
displayed type in, or use 
light pen to enter the 
address in six hex digits 



If the function requires 
an address the cursor moves 
,to the first digit under KEY 
IN/ADDRESS (see note 
below) 



The cursor moves to the 
right until the address is 
complete 




Press ENTER, or COPY 
or press light pen to 
lozenge ■ COPY. 



Press CANCEL 







o 




Note; 

An address is not required to 

alter or display the following: 

• Control registers 

• General purpose registers 

• Floating point registers 

• Program status word 



The program frame 
displayed prior to this 
operation is re-displayed 



Press START 



J 



When using COPY and ENTER: 

Using COPY will only produce a "hard copy" of lines that have been changed by entering new data. 

Using ENTER in display mode will not produce a "hard copy". 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
(ALL MODELS) 



This console facility allows the operator to check and obtain a hard copy of each 
instruction address executed during program operation. 

Combining this facility with the console printer ALTER/DISPLAY feature 
described in D-1 of this section, provides a procedure to trace and record the path 
of a short loop. 

Note: The different types of loops and their causes are described in Section 1. 



( 



When to use (all Models) 

This facihty should be used when the system malfunction prevents the use of 
SDAIDS to trace the loop. It is also useful during hands-on debugging when only 
small parts of a program require accurate program flow analysis. 

Flowcharts in Section 3 indicate to the operator when a loop is to be traced using 
this console faciUty. 



INSTRUCTION STEPPING 
MODELS 135, 138, 145, 
148, AND 155-11 



How to use 

A procedure for tracing and recording the path of a loop using the instruction step 
facility of the Models 135, 138, 145, 148 and 155-11 is shown in the flowchart 
opposite. 



X: 



f 
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Start 



Aids provided by the Operator's Console 

INSTRUCTION STEPPING 

MODELS 135, 138, 145, 

148, AND 155-11 



o 



Press STOP and wait until 
MAN indicator turns on 



Set RATE switch to 
INSTRUCTION STEP 



On printer-keyboard: 
Press ALTER/DISPLAY 
and wait until PROCEED 
light turns on. 
On Model 138/148 
Display Console: 
Press MODE SEL key 



Printer-keyboard: 

Type in DP and then press 

END to terminate Alter/ 

Display mode. 

Model 138/148 Console: 

Type in DP and press 

ENTER to display PSW. 

Press PF5 to print screen 

contents. 

Press ENTER to terminate 

Alter/Display mode. 




Carrier return and line feed occurs. ALT/DISP 
MODE light (printer-keyboard) turns on. 
If this does not occur, press CANCEL on the 
printer-keyboard, and press the ALTER/DISPLAY 
key again. Model 138/148 Console: The current 
contents of the screen are saved and replaced 
by the Alter/Display frame. 



The contents of the current PSW 
are printed. 




NO 



Press START and wait until 
SYS indicator turns off 



Set RATE switch 
to PROCESS 



To continue system 
operation, press the 
START key 



The procedure for tracing a loop using instruction step method 
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Aids provided by the Operator's Console 

How to use 



INSTRUCTION STEPPING 
MODELS 115 AND 125 



INSTRUCTION STEP 
offers two modes: 
landP 



The INSTRUCTION STEP display allows the operator to check and make a note 
of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

To select the instruction step display shown below: 

1 . Type I into the mode select display. 

2. Press ENTER. 



INSTRUCTION STEP 



OPERATION R ATE 

I INSTRUCTION STEP 
P PROCESS 



I INSTRUCTION STEP 



P PROCESS 



.If I is typed into the instruction step display and ENTER is pressed, the new data 
can be seen as soon as the stop occurs. Line 14 (in the machine status area) shows 
the address and the data at this address. 

.As soon as START is pressed the screen is returned to the operating system and 
operating messages can be traced with, each step. Instruction step mode is indicated 
by I-STEP on hne 15 (in the machine status area). Entering P is used to end the 
instruction step mode. 

1. Type in P. 

2. Press ENTER 

The last picture. of the operating system is brought back to the screen. 
Press START to continue processing. 



( ^^ 
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Aids provided by the Operator's Console 



o 



INSTRUCTION STEPPING 
MODELS 115 AND 125 



Press MODE SELECT 



Type in II and press ENTER 



o 



k ,,;| The machine stops and the previous 
"i'fj display disappears 



Press START 
Wait until MAN appears 
on line 13 and l-STEP 
appears on line 14 



When START is pressed, the instruction 
step display disappears and the screen 
is returned to the operating system. 
For each depression of START, one 
machine-language instruction is processed. 
CPU then services any pending 
interruptions before entering manual state. 



Make a note of the 
instruction address and con- 
tents displayed on line 14 



Yes 





No 



Press MODE SELECT 



Type in IP and press 
ENTER 



(Fast Selection) 

Instruction step mode is cancelled. 



To resume processing 
press START 



The procedure for tracing a loop using the instruction step method 
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Aids provided by the Operator's Console 



INSTRUCTION 
STEPPING 
MODEL 158 



The INSTRUCTION STEP display allows the operator to check and make a note 
of, or obtain a "hard copy" of each instruction address during program operation. 

Making a note of the instruction addresses executed each time the START button 
is pressed provides a procedure to trace and record the path of a short loop. 

How to use 

With the manual frame displayed, shown below, after pressing MODE SEL, the 
R-RATE switch must be set to I-STEP by either typing in R2 or by pressing the 
light pen to lozenge ■ 2-I-STEP. The selection is indicated by an arrow displayed as 
shown in the example below. 



"■^ 



.J' 




The instruction address of the current instruction will be in the address part of 
the PSW displayed on line 25, 

Pressing the START key will cause the CPU to execute the next instruction in 
logical sequence, the address of which will be displayed in the PSW as before. 

In display mode of operation a "hard copy" of the PSW displayed can be obtained 
on the 3213 printer, if attached, by pressing the COPY key or by pressing the 
light pen to lozenge COPY. 

To return to normal CPU processing rate, type in Rl or hold the light pen against 
■ 1 -PROCESS and press MODE SEL followed by START. 
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Aids provided by the Operator's Console 

INSTRUCTION 

STEPPING 

MODEL 158 



c 



Press STOP 



D 



Press MODE SEL 



The MANUAL frame is 
displayed 



Type in R2, or press 
light pen to lozenge 
■ 2-l-STEP 



Press START 



Press COPY 

or press light pen 

to lozenge ■ COPY 



The word SYS will be displayed 
momentarily, and the instruction 
address will be displayed in the 
PSWon line 25 



A "Hard copy" of the frame 
displayed can be obtained on 
the 3213 printer, if attached 



Yes 




D 6-F 



No 



Type in R1 or press 
light pen to lozenge 
■ 1 -Process 




Yes 



No 



Select new mode 



Press MODE SEL 
or CANCEL 






( Press START J 



The procedure for tracing a loop using the instruction step method on the Model 158 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 

COMPARE 

(ALL MODELS) 



This facility enables you to stop all system activity at any selected storage address 
during system operation. Two methods are provided on the System/370 that 
enable both hardware and software-controlled stops: 

1 . By using switches on the system control panel 

2. By using the SDAID stop on event facility. 

For the Models 145, 148, and 155-11 the system control panel switches enable 
a stop on real or virtual address. 

The Models 115, 125, 135, and 138 have system control panel switches that 
do not allow for a stop on a virtual address. 

Stop on event for all models is described under SDAIDS, Section 2-B-8. A flow- 
chart in Section 2-B- 10 shows how to initiate and execute this aid. 



/f^, 



When to use (all Models) 

This facility is a hands-on debugging aid for the programmer, and permits him to 
stop system operations at selected addresses in the program listings. He can use it, 
for example, in conjunction with either the console ALTER/DISPLAY feature, 
or the ALTER, DSPLY and DUMP commands, to change the contents or display 
particular areas of storage at selected addresses in a program. The operator is also 
able to use this facility if, for example, the programmer requests a dump of 
certain storage locations at particular points in a program during execution of 
the program. 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 138, 
145, 148, AND 155-li 



How to use 

Four switches on the system control panel are used during address compare 
operations: 

• ADDRESS COMPARE CONTROL (Toggle) 

• ADDRESS COMPARE (Rotary) 

• STORAGE SELECT (Rotary) 

• INTERVAL TIMER (Toggle). 

The flowchart opposite shows the procedure for stop on address compare appUcable 
to System/370 Models 135, 138, 145, 148, and 155-11. However, because the 
ADDRESS COMPARE rotary switch differs between models, the IBM operating 
procedures for the model on which the operation is to be executed must be 
consulted. 



v.. y 
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Aids provided by the Operator's Console 

STOP ON ADDRESS 

COMPARE 

MODELS 135, 138, 

145, 148, AND 155-11 



Start 



J 






Press STOP 



Ensure STORAGE SELECT 
is set to MAIN STORAGE 



Set INTERVAL TIMER 
to DISABLE 



Set rotary switches A 
through E (STORAGE ADD- 
RESS) to desired stop 



Set ADDRESS COMPARE 
to select desired condition 
for stop, for example, ANY 



Set ADDRESS COMPARE 
CONTROL three-position 
lever switch to STOP 



Press START 



Modelsl 35,1 38,1 45and 1 48: 
When address accessed by 
CPU matches selected address 
CPU stops at the end of in- 
struction in progress. 



Set: 

1. ADDRESS COMPARE 
to ANY 

2. ADDRESS COMPARE 
CONTROL to SYNC/ 
NORMAL 

3. INTERVAL TIMER to 
NORMAL (if required) 



Press START 



. Address 
> Comparison 
Stopping 



Resumption 
(of 
r Normal 

Processing 



J 



Switch positions for selecting the 
conditions for the stop are different for 
each of the System/370 Models. Consult 
Compare Type Selection on the next 
two pages and the note below. 




Note: 

See ADDRESS COMPARE and 
ADDRESS COMPARE CONTROL 
CONTROL switch setting for each 
System/370 model as described in the 
IBM-supplied Operating Procedures 
manual belonging to the system. 



A procedure for using the stop on address compare facility. 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 
COMPARE 
MODELS 135, 138, 
145, 148, AND 155-11 



Compare type selection (Models 135 and 138) 



ADDRESS COMPARE 



ANY 



DATA 
STORE 



oiC 




o|/0 



. DATA STORE: 
X-'- A match occurs when the selected location is addressed to store data. 

ANY: 

The normal operating position — a match occurs when the selected location is 

addressed for any type of operation, 

IC: 

, A match occurs when the selected location is addressed by an instruction. 

I/O: 

A match occurs when the selected location is addressed for an I/O data transfer. 



Compare type selection (Model 155-11) 



ANY (Real Address) 



This position of the switch is used for normal program processing. With the switch 
in this position, a match occurs for main storage access when the storage address 
matches the address set in console switches CDEFGH. 



\.-J 



I ADDRESS COMPARE 
ANY 

FETCH o^,--rrN.o lAR 



STORE 




FETCH 

This position causes a match when the storage address matches the address set in 
console switches CDEFGH, and the operation is a data fetch from main storage. 

STORE 

This position allows a match when the storage address matches the address set in 
console switches CDEFGH during a data store operation. 

lAR 

This position of the switch allows a match when the lAR (instruction address 
register) address matches the address set in console switches CDEFGH. 

I/O (Input/Output) 

This position of the switch allows a match when the storage address matches the 
address set in console switches CDEFGH, and the operation is a data store or fetch 
for an I/O operation. 
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Aids provided by the Operator's Console 



Compare type selection (Models 145 and 148) 
ANY (Logical Address) 

This position of the switch allows a match when the logical 
main storage address used to access storage matches the 
address set in console switches CDEFGH. 

ANY (Real Address) 

This position of the switch is used for normal program \ '■ 

processing. With the switch in this position, a match occurs ,; f}-^^ 

for main storage access when the storage address matches ;;;r'^; 

the address set in console switches CDEFGH. ';?,l 

DATA STORE {^1;^V 

This position allows a match when the sotrage address ;"J; ^ J 

matches the address set in console switches CDEFGH during ; ^ v- \,^ / ; ; 
a data store operation. ' b;'\ ^' '.'\ 

I/O (INPUT/OUTPUT) ;HVr /' 

This position of the switch allows a match when the storage / , - _" \ J 

address matches the address set in conssole switches \^; --r ;;/; 

CDEFGH, and the operation is storing or fetching data for " "' ' ' ':- < 
an I/O operation. ' : 

l-COUNTER (Real or Logical Address) 

This position causes a match when the real or logical main . ^ 

storage address matches the address in console switches , , 

CDEFGH, and the operation is an instruction fetch from 
main storage. p 

NOTE: Significant throughput degradation can occur while processing with ttiis 
switch set to the l-COUNTER REAL ADR position. 



STOP ON ADDRESS 

COMPARE 

MODELS 135, 138, 

145, 148, AND 155-11 



ADDRESS COMPARE 



ANY 



ANY 
LOGICAL 
ADR 
I COUNTER 

CTRL WORD • 
ADR 
CTRL WORD • 
TRAP 




•DATA STOR 



•l/O 



REAL 
ADR 



• I COUNTER 



•DATACOMP 
TRAP 



I Data compare trap (Models 145 and 148) 

This facility is useful during hands-on debugging to determine what instruction is 
causing a particular storage byte location to be modified. 

1. Press STOP. 

2. Set the ADDRESS COMPARE switch to DATA COMPARE TRAP. 

3. Set the address of the storage byte location being modified in console 
switches CDEFGH. 

4. Set data switches A and B to the desired byte match value. 

5 . Set the ADDRESS COMPARE CONTROL toggle switch to STOP. 

6. Press START. 

When a store operation modifies the specified storage byte location to the value set 
in switches A and B, the ADR COMP MATCH indicator is turned on and the CPU 
enters a soft-stop state. 

To determine the address of the instruction that modified the storage byte, display 
the current PSW, and subtract the current instruction length code from the 
instruction address in the current PSW. 

Note: 

The instruction found with this procedure may not have modified the data. An 

IjO data trap occurring during execution of this instruction could have modified 

the data. To determine which I/O data trap modified the data, log the address 

displayed in the A-Register Display roller switch indicators and call your service 

representative. 




Serviceability Aids 2.171 



Aids provided by the Operator's Console 



STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 



How to use 

Before this facility can be used the mode select display must be brought to the 
screen by pressing the MODE SELECT key. 

To select the storage ADDRESS COMPARE display shown below: 

1 . Type in 'C beside MODE SPECIFICATION on the mode select display. 

2. Press ENTER. 



c 






Error Indications 

If you make an error when typing in 
the code or hex characters: 

• The address compare display stays 
on the screen. 

• INVALID CHARACTER appears. 

• The cursor marks the location of the 
first error. 

The display remains on the screen 
as long as an entry error has not been 
corrected. When there is no error, 
the display disappears after ENTER 
is pressed. 



MAIN STORAGE ADDRfcSS COMPARE > 



P PROCESS 



COMPARE TYPE 



D DATA STORE 



C INSTR. COUNT 



STORAGE ADDRESS 



Three columns are displayed and an entry must be made under each column. 

S STOP: the machine stops when the address has been found. 

ACTION i ^ SYNC: a signal for the customer engineer is given when the address has been 
found. 

(^ P PROCESS: address compare mode is turned off and normal processing continues. 

' A ANY: the CPU will compare your search address (the address you type into 
column three) against all addresses used in the system. 

D DATA STORE: the CPU will compare your search address against only those 
storage addresses used to store data. 

Your search address will not be compared against addresses used in transferring 
data to or from I/O devices. 

I I/O DATA: the CPU will compare your search address against only those 
storage addresses used in transferring data to or from I/O devices. 

C INSTR COUNT: the CPU will compare your search address against only those 
addresses used when fetching instructions. 

STORAGE ADDRESS < The real storage address at which the stop is to occur. 



COMPARE TYPE <• 



\ .-/ 
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Press MODE SELECT 



The machine stops and the display 
disappears. 



STOP ON ADDRESS 

COMPARE 

MODELS 115 AND 125 






Type in Cand press 
ENTER 



Type in S (or Y) 



Type in code for type 
of data to be compared 



Type in real storage 
address (6 hex digits) 



Press ENTER 



Processing continues until 
address is found. Then 
System stops. 



Press START 



IVIake a note of the data 
displayed on line 15 




YES 



Press MODE SELECT. 
Type in CP, 
Press ENTER. 



To resume processing 
press START 



Y is for CE use only. 



Codes are: 
A = ANY 

D = DATA STORE 
1=1/0 DATA 
C = INSTR COUNT 



(See the description 
of the codes on the 
opposite page) 



Addresses outside the real address area cause 
message INVALID ADDRESS to be displayed 



Address compare display is replaced but 
specifications entered are displayed on line 14 
of the new display 



• The last operating message stays on the 
screen. 

• MAN appears. 

• The addresses on lines 14 and 15 are the 
same. 




Stop on Address Compare mode is 
cancelled 



Fast Selection: You can type your specifications for address compare directly 
into the mode select picture. For example, you can type CSC005FAC, without 
commas or blanks to specify Compare with action Stop during instruction 
fetching with address 005FAC. 
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Aids provided by the Operator's Console 



STOP ON ADDRESS 
COMPARE 
'MODEL 158 

STOP ON A REAL ADDRESS 



COMPARE TYPE 

Note: If STOP is not selected 
a 'sync' pulse will be generated 
on true comparisons and the 
CPU will not stop. 



STOP ON A VIRTUAL 
ADDRESS AND DATA 
COMPARE TRAP 



r 



How to use 

Before this facility can be used the MANUAL frame must be brought to the screen 

by pressing the MODE SEL key. 

To stop on a real address S-SAR COMP SEL(REAL) must be used in conjunction 
with E-SAR COMP SEL(REAL). 

1 . Select the STOP function ■ 5-STOP or type in S5 

2. Select the compare type (see below) 

3 . Enter a real address at E-SAR COMP SEL(REAL). 

A stop will occur on any quadword boundary of a selected real address 






1-ANY: the CPU will compare the address set under E with all addresses used in the 
real address area. When a true comparison is met the CPU will stop. 
2-STORE: causes the CPU to stop when a STORE operation is performed on the 
location at the address entered under E. 

3-FETCH: causes the CPU to stop when a FETCH operation is performed on the 
location at the address entered under E. 
^ 4-1/0: causes the CPU to stop when data is transferred either to or from the 
location at the address entered under E. 

The example below shows the appearance of the manual frame after selecting a 
stop on a FETCH operation on the location at real address 007FF8. 




\, 



A facility on the System/370 Model 158 allows a stop on a virtual address with a 
maximum of 6 conditions described in the table below. 



FUNCTION 


CPU ACTION 


USAGE 


G1 -STORE 
G2-IAR 


Stops processing after a store to the virtual address specified 
inADRI. 

Stops processing after an instruction fetch to the virtual 
address specified in ADR1. 


The cursor can be backed up under the digit to the left of the 
period and the base register entered in that position. The six 
digits to the right of the period are used to contain the dis- 
placement. The DATA fields and the ADR2 and ADR3 fields 
can be used to further define the stop conditions, giving a 
maximum of six conditions that must be satisfied before a 
stop occurs. The C to the left of the period in the data field 
signifies that the specified data will be compared. When the 
C is changed to a 1 , the specified bits are compared. 

Examp/e: If the character to the left of the period is changed 
to a 1, and 1A is entered in the DA TA field, a stop occurs 
whenever bits 3, 4, and 6 are on. Conversely, if the C is 
changed to aO,a stop occurs whenever bits 3, 4, and 6 are 
off. 


H1-ADR1 
H2-DATA 


Specifies the first condition that must be met in order for 
a stop to occur. 

Specifies the data that must be found at the address in 
ADR1 for a stop to occur. If DATA Is not pressed, the stop 
occurs whenever the location specified by ADR 1 is 
addressed. 


H3-ADR2 
H4-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 


H5-ADR3 
H6-DATA 


Specifies additional conditions that must be met if a stop 
is to occur. 
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Aids provided by the Operator's Console 



Press STOP 



Press MODE SEL 



Type in S5 or press 
light pen to lozenge 
■ 5-STOP 



The manual frame will be displayed 



, If STOP is not selected, a sync pulse 
f', only is generated on true comparison 
for use by the IBM CE 



Type in a code number 
or use the light pen, to 
specify the type of 
compare required 



Type in a six digit 
addresss in hexadecimal, 
or use the light pen at HEX 
INPUT on the display. 



o 



Press ENTER or COPY 



Processing continues 
until address is found. 
Then System stops. 



Press START 




Yes 



STOP ON ADDRESS 

COMPARE 

MODEL 158 



Codes are: ^ 

1-ANY I [see the description 
2-STORE i J of the codes under 
3-FETCH? ] COMPARE TYPE 
4-1/0 > I on the opposite Rage. 

The address will be displayed as 
it is entered at E-SAR COMP 
SET (REAL) The address 
specified must be within the 
real address area 



Using Copy will cause the entire 
manual frame to be printed on 
the 3213 printer 



The word MAN will be 
displayed at the lower right 
corner of the display 



Press CANCEL 



The manual frame is replaced 
by the program frame 




To resume processing 
press START 
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CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



This operation provides a non-destructive readout and printout of any real storage 
area (up to 64K bytes at a time). The command can be executed at any time, and 
the (dumped) program can continue as soon as dumping is completed (no IPL or 
restart required). 
To select the storage dump display: 

1 . Type D into the mode select display. 

2. Press ENTER. 

The display shown below appears on the screen. 



"'X 



MAIN STORAGE DUMP 



Error Indications: 

PRINTER NOT READY appears 
if the line printer is not ready. 
STORAGE END appears if the 
start address is greater than the 
physical size. 

INVALID CHARACTER appears 
for any non-hex digits. 
INCOMPLETE ENTRY appears 
when necessary. 



ENTER START ADDRESS: 00 03 00 
END ADDRESS: " 12 FF 



STORAGE END 



How to use 

1. Type in the start and end addresses. Remember that: 

• The low order halfword must be two zeros. 

• The end address must be within 64K bytes from the start address, and the 
low -order halfword must be FF. 

• If the dump required is more than 64K bytes, repeat the operation with 
a new start and end address. 

2. Press ENTER. 

• Dumping can be stopped at any time by pressing MODE SELECT, CANCEL, 
or START. If one of these keys is pressed, DUMP CANCELLED appears on 
the screen. 

• DUMP COMPLETE appears on the screen when the selected dump range has 
been printed. 

• STORAGE END appears on the screen when the upper hpundary of storage 
has been reached. 

The flowchart shown on the opposite page shows the procedure for using this 
command. 



\, _y 



When to use 

This is a useful aid to use when large areas of real storage must be recorded for 
later analysis. It can also be used instead of the ALTER/DISPLAY feature to 
record low address storage before executing the stand-alone dump program. 
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Press MODE SELECT. 

Type in D. 

Press ENTER. (OOE) 



o 



CONSOLE DUMP 

OPERATION 

MODELS 115 AND 125 ONLY 



Ready the 
Line printer 



Enter the starting and 
ending addresses in hex 



Press ENTER 



The end address cannot be 
more than 64K fronn the start 
address 



Dumping begins 



Press MODE SELECT 
CANCEL, or START. 




DUMP CANCELED 
is displayed 



Press CANCEL 



The dump display disappear. 



To resume processing 
Press START 



/ 



Processing continues 



NOTE: If a log or retry operatfon takes place at the same time as a 
dump request, PRESS CANCEL appears on the screen. After pressing 
CANCEL, the message LOG IN PROGRESS appears in the machine 
status area. You can repeat durnping as soon as the log message 
disappears. 



D-10-F 
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STORE STATUS 
(ALL MODELS) 



This function enables certain control information to be stored and preserved for 
analysis by the IBM CE. 

Models 135, 145 and 155-11 

1 . Press the console printer keyboard ALTER/DISPLAY key. 

2. Type in ST. 

The information saved is identical to that listed below for the Model 125 

Models 138 and 148 

1. Press the display keyboard MODE SEL key. 

2. Type in ST. 

The information saved is identical to that Usted below for the Model 125. 

Models 115 and 125 

There is no display for STORE STATUS. 
To store the status: 

1. Type S into the mode select display. 

2. PressENTER. numn-.- 






The following information is stored. 

• CPU Timer 

• Clock Comparator 

• The current PSW 

• Floating-Point Registers 

• Control Registers 

• General Registers. 

After ENTER has been pressed; 

• The mode select display remains on the screen and STATUS STORED appears. 

• The system goes into the stopped state. 

• The S has disappeared from the mode specification field, so this field is free 
and another operation can be specified. 



\ / 



O-OPERATOR FUNCTIONS 
1-PSW RESTART(PRGM) 
2-RESTART(PRG[VI) 
3-SYSTEM RESET 
4-LOAD 

5-STORE STATUS 
6-SYS REST(CLEAR) 
7-LOAD(CLEAR) 



1- 


LOAD UA 
000 


W-SWAP 
SAR 13 


X 


-EXECUTE 
OPERATOR FUNCTION 



> < 



Model 158 

1. Press MODE SEL to obtain the manual frame. 

2. Type in 03 or hold light pen against ■ 3-SYSTEM RESET. 

3. Type in X or press light pen to lozenge ■ OPERATOR FUNCTION. 

4. Type in 05 or press Ught pen to lozenge ■ 5-STORE STATUS. 

5. Type in X or use light pen at ■ OPERATOR FUNCTION. 

A new function may now be selected. 

When to use 

This function should be used before executing the stand-alone dump program. 
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Models 135, 138, 145, 148 and 155-11 CLEAR REAL STORAGE 

1? w K 1 ^. u .u .u ■ . (ALL MODELS) 

Real storage can be cleared to zeros by the following procedure: 

1 . Press and hold in ENABLE SYSTEM CLEAR. 

2. Press SYSTEM RESET or LOAD. 

3. Re-IPL to continue processing new job. 

Note: Control storage is unaffected. 

Models 115 and 125 

1 . Press the MODE SELECT key. 

2. Type RC into the mode select display. 

Note: AtlPL time one of the LOAD parameters is NORMAL or CLEAR 

Model 158 

Two methods are available on the Model 158 to clear real, or main storage. 

1 . System Reset (Clear): In addition to performing the reset function, this causes 
main storage and the storage-protect arrays to be validated (cleared to zeros with 
good parity), 

• Press MODE SEL to obtain the manual frame. 

• Type in 06 or hold light pen against ■ 6-SYS RESET (CLEAR). 

• Type in X or hold light pen against ■ OPERATOR FUNCTION. 

2. Load (Clear): In addition to performing the load function, this causes the IPL 
function to be preceded by an initial program reset, and clears main storage and 
the storage-protect arrays. 

• Press MODE SEL to obtain the manual frame 

• Enter a load unit address 

• Type in 07 or hold the light pen against ■ 7-LOAD (CLEAR). 

• Type in X or use light pen at ■ OPERATOR FUNCTION. 

V\^en to use 

This faciUty should be used with caution. An example of Its use is to reset the 
hardware after a machine check is caused by a parity error in real storage. It must 
be used after you have gathered all the information from the system. 
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SAVE USAGE COUNTERS 
(MODELS 115/125) 



There is no display for SAVE USAGE COUNTERS. 
To select the save usage counters operation: 

1, Type U into the mode select display. 

2. Press ENTER. 

When to use 

This operation saves the usage counters of all disk drives. The operation should 
always be performed before you turn the power off so that the information can be 
used by the CE for maintenance. The message 'counter saved' appears for each 
counter that is recorded. 
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JOB CONTROL 
COMMANDS AND 
STATEMENTS 



The following commands and statements are not primarily designed as 
serviceability aids, but enable useful information to be obtained from the system 
during program execution. 

For example, it is useful to place the LISTIO statement and command in job 
streams where device assignments are suspected of causing errors. The LOG 
command enables you to record job control statements and commands issued 
on SYSLOG during a job, and the MAP command enables you to check partition 
allocation. These three commands, LISTIO, LOG, and MAP can be used therefore 
as a "job stream trace," as shown in the example opposite. 

In certain cases of system malfunctions, this information, used in conjunction with 
dumps and trace routine output, will help during offline debugging. 



c 



^\, 



LISTIO or //LISTIO 

The LISTIO command or statement (List I/O Assignment) causes the system to 
print a Usting of I/O assignments. The listing appears on SYSLOG (command) or 
SYSLST (statement). If SYSLST is not assigned, the LISTIO statement is ignored. 



Statement Format 



II LISTIO — 



SYS 

PROG 

BG 

Fn 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



— (output on SYS LSt) 



\.:j 



Command Format 



LISTIO 



SYS 

PROG 

BG 

Fn 

ALL 

SYSxxx 

UNITS 

DOWN 

UA 

X'cuu' 



(output on SYSLOG) 



The table following the example opposite explains the meaning of the LISTIO 
options. 
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(O 



K-yiRT UPPER LIM 

40000 

292K i-im-Pf" 

80K 9(:M"FF 

80K DO!"F 

lOOK (;!P|:: 

120K !;-;7FF!"' 

9AK fffff 

68K PVTFF 





An example of a "job stream trace" for a five-partition system using the LOG, MAP, 
LIST[0 and PAUSE commands and statements. 
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Options for LISTIO 



Options 


Meaning 


SYS 


Lists the pihysical units assigned to the system logical units. (See note). 


PROG 


Lists the physical units assigned to the background programmer logical units. (See note.) 


BG 


Lists the physical units assigned to the background logical units. 


Fn 


Lists the physical units assigned to the logical units of foreground partition n. n can have a value of 1 through 
the highest numbered foreground partition available in the system. 


ALL 


Lists the physical units assigned to all logical units. 


SYSxxx 


Lists the physical units assigned to the logical unit specified. The assignment is given for the partition from 
which the command is given. (See note.) 


UNITS 


Lists the logical units assigned to all physical units. (See note.) 


DOWN 


Lists all physical units specified as inoperative. (See note.) 


UA 


Lists all physical units not currently assigned to a logical unit. 


X'cuu' 


Lists the logical units assigned to the physical unit specified. 



Note: Physical units are listed with current device specification for magnetic tape units. Logical units are listed with ownership 
(background, or any foreground), when applicable. If a unit has a standard assignmen t in one mode and a temporary assignment 
in another mode, the CMNT column identifies the type of assignment for each indicated mode. All channel unit numbers are 
represented in hexadecimal. 



LOG 



The LOG job control command causes the system to log, on SYSLOG, columns 
1-72 of all Job Control commands and statements occurring in the batched-job 
partition in which the LOG is issued. The AR LOG affects all the partitions. The 
LOG function is effective until a NOLOG command for the partition involved is 
sensed. 

The format for the LOG job control command via attention routine is as follows: 
LOG blank 

The operand field is ignored by the system. 

NOLOG 

The NOLOG command (suppress logging) terminates the listing, on SYSLOG, of 
Job Control commands and statements (except JOB, PAUSE, STOP, ALLOC, 
MAP, HOLD, RELSE, UNA, DVCDN, DVCUP, *, and /&) that occur in the 
batched-job partition in which the NOLOG is issued. The NOLOG function is 
effective until a LOG command for the partition involved is sensed. 

The format for the NOLOG job control command via attention routine is as 
follows: 

NOLOG blank 

The operand field is ignored by the system. 
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MAP 

The MAP command produces on SYSLOG a map of virtual storage areas allocated 
to programs. 

An example of the output produced on the console printer for a five-partition 
system is shown below: 



Other Aids 

JOB CONTROL 

COMMANDS AND 

STATEMENTS 





Bi 


■1 




Hi 




mBH 














T2 


map 


















• 


F2 
F2 
F2 


AREA 
SP 


K- 


-REAL 
92K 


UPPER LIM 

:IA!"FF 


K-VIRT 


UPPER LIh 

40000 


NAME 






• 


F2 


BG 


V5A 


30K 


:I.E7F!-- 


292K 


&BfFF 


KENSLOOP 






F2 


F4 


14 


lOK 


20FF-F 


80K 


9(;;fi"'f 










F2 


F3 


U3D 


lOK 


2:^7FF 


80K 


BOFFF 








• 


F2 


F2 


V2A 


14K 


26FFF 


lOOK 


n9l"-FF 


NO NAME 






F2 


Fl 


11 


82K 


3B7FF 


120K 


l::.7FI"l"' 










F2 


SVA 








96K 


|::|::|::-|::']::' 








^ 


F2 


VIS 








68K 


FF-FF-f" 








F2 


PP 




18K 


3FFFF 






^^^^^MUt 






n 






H 




HHH 












Explanation of the output: 





SP = Supervisor, V = Virtual, PP = Main Page Pool, 1 = Inactive, SVA = Shared Virtual Area, R = Real, 
A = Active, D = Deactivated 

1, 2, 3, ... = Partition Priority (1 = highest priority), VIS = Amount of SVA reserved by GETVIS 
parameter of the VSTAB system generation macro 


K-REAL 


gives the number of bytes allocated to the real partition or the number of bytes of the main page pool. 
The size is given in multiples of 2K. 


UPPER LIM 


shows the highest storage addresses in hexadecimal of the respective real partition, of the supervisor, 
and of the main page pool. 


K-VIRT 


specifies the number of bytes allocated to the respective virtual partition. The size is given in muJtiples of 2K. 
This field is blank for the supervisor and for the main page pool. 


UPPER LIM 


contains the highest storage address in hexadecimal of the respective virtual partition. For the supervisor, 
this field specifies the start address of the virtual address area. This field is blank for the main page pool. 


NAME 


contains the name of the job which is currently executing in the corresponding partition. This field is blank for 
the supervisor, SVA, VIS, and for the main page pool. When the listing shows NO NAME for the background, 
or when the name field is blank for a foreground partition, no program is being executed in that area. However, 
the name field for any partition contains NO NAME when no job control statement or command was entered, 
but the program is active. 



Note: If a program issues an SVC 55, some page frames in the main page pool (PP) will also belong to that program. Therefore, 
to calculate the total area in real storage occupied by that program, the MAP command should be issued before running it. The 
difference between the number ofK in the PP before running the program, and the number ofK during the execution of the 
program is the amount ofK seized by the SVC 55. This also applies when PDAID output mode is an alternate area or the SDAID 
is initiated. In this case, the area occupied by the PDAID or SDAID is printed during their initialization. 

Note: The output does not indicate storage temporarily added to the page pool as a result of using the SIZE parameter of the 
EXEC statement. 
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OPTION 

The OPTION statement specifies one or more of the Job Control options. The 
format of the OPTION statement is: 

JCS Format 

//OPTION option 1 (,option2,..,) 

The options that can appear in the operand field follow. Selected options can be 
in any order. Options are reset to the standards estabHshed at system generation 
time upon encountering a JOB or a /& statement. 

DUMP Causes a dump of the registers and main storage to be output on 

SYSLST, if assigned, in the case of an abnormal program end. 
(See A-2 in this section for a full description.) 

PARTDUMP Has the same function as the DUMP option, except that when the 

PARTDUMP option is specified, the supervisor will not be dumped in 
its entirety. (Refer to "System Dump" at the beginning of this section.) 

NODUMP Suppresses the DUMP option, if the latter was specified in the STDJC 
macro during system generation. 

LOG Causes the listing of columns 1 -80 of all control statements on 

SYSLST. Control statements are not listed until a LOG option is 
encountered. Once a LOG option statement is read, logging continues 
from job-step to job-step until NOLOG option is encountered or until 
either the JOB or /& control statement is encountered. 

NOLOG Suppresses the Hsting of all valid control statements on SYSLST until 

a LOG option is encountered. If SYSLST is assigned, invalid 
statements and commands are Hsted. 

LIST Causes language translators to write the source module listing on 

SYSLST. In addition, it causes the Assembler to write the hexadecimal 
object module Hsting and causes the Assembler and the FORTRAN 
compiler to write a summary of all errors in the source program. All 
are written on SYSLST. 

NOLIST Suppresses the LIST option. 






V 



PAUSE 

The PAUSE command causes a pause at the end of the current job step. The 
PAUSE Job Control statement causes a pause immediately after processing this 
statement. At the time, SYSLOG is unlocked for message input. Pressing the 
END or ENTER key causes processing to continue. The PAUSE statement or 
command always appear on SYSLOG. If a 3210 or 3215 or video console 
display unit is not available, the PAUSE statement or command is ignored. 
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This is an area of real storage, starting at byte address 000000, and permanently LOW ADD R ESS 

reserved for use by the supervisor. STO R AG E 

For the purpose of program debugging, low address storage extends up to byte 
address 160 decimal (X'BF') 

Displaying low address storage 

Low address storage will always be dumped during the execution of: 

• A stand-alone dump; see A-2 in this section. 

• A system dump; see A-2 in this section. 

• A transient dump (bytes 0-144 hex); see A-4 in this section. 

Low address storage can also be dumped by means of the ALTER/DISPLAY 
feature on the console printer or display unit keyboard (see D-1 in this section). 



When to display 

Low address storage must be dumped by using the ALTER/DISPLAY console 
printer feature whenever a hard wait is recognized. 




Flowchart D-1 -F in this section shows how to dump low address storage by using the 
ALTER/DISPLAY feature on the console printer. Flowcharts in Section 3 indicate 
when to dump low address storage. 



CAW (Channel Address Word) 

The CAW specifies the storage protection key and the address of the first channel 
command word associated with the START I/O instruction. The CAW is found at 
hex location 48. 



KEY 


0000 


Channel Command Word Address 



31 



Note: After the execution of any dump program, the information in the CAW is 
unreliable. In this case, the address of the CCW is found in the command control 
block (CCB). 

Locating CCBs is described in Section 4. 
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CSW (Channel Status Word) 

The CSW informs the program of the status of an I/O device or the conditions 
under which an I/O operation has been terminated. The CSW is formed, or parts 
of it are replaced, during I/O interruptions and during execution of I/O 
instructions. The CSW is placed in low address storage at location hex 40. It is 
available to the program at this location until the next I/O interruption occurs or 
until another I/O instruction generates a new CSW, whichever occurs first. 
The I/O device is identified by the address in the I/O Interrupt Code (at X'B8'). 
The information placed in the CSW by an I/O instruction pertains to the device 
addressed by the instruction. 

The CSW format is shown below. 



Key 





L 


CC 


Channel Command Address 


Unit Status 


Channel Status 


Count 11 





4 




6 


8 


32 


40 


48 63 



Bits 0- 3 


Protection key used in the last operation 


Bits 4- 5 


Reserved 


Bits 6- 7 


Deferred condition code 


Bits 8-31 


Address plus 8 of the last CCW used 


Bits 32-39 


contain the unit status byte: 




Bit 32 — attention 




Bit 33 — status modifier 




Bit 34 — control unit end 




Bit 35 — busy 




Bit 36 — channel end 




Bit 37 — device end 




Bit 38 — unit check 




Bit 39 — unit exception 


Bits 40-47 


contain the channel status byte: 




Bit 40 — program-controlled interruption 




Bit 41 incorrect length 




Bit 42 — program check 




Bit 43 — protection check 




Bit 44 — channel data check 




Bit 45 — channel control check 




Bit 46 — interface control check 




Bit 47 chaining check 


Bits 48-63 


Residual count of the last CCW used 



4 



Note: After the execution of any dump program, the information in the CSW is 
unreliable. In this case, CSW information is found in the command control block 
(CCBj. 

Locating CCBs is described in Section 4. 
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PSW (Program Status Word) 

The PSW contains information required for the program execution. By storing the 
PSW, the control program can preserve the status of the CPU for later inspection. 
By loading a new PSW or part of a PSW, the status of the CPU can be changed. 

The format of old and new PSWs is the same as that of the current PSW, shown 
below: 



LOW ADDRESS 
STORAGE 



u 


R 


U 


U 





T 


1 


E 


Protection 
l<ey 


1 


M 


W 


P 


U 


U 


C 


C 


Program 
mask 


Unassigned 


Reserved 


^ Instruction Vv 
J) address JJ 



















8 










16 








20 


24 


33 


40 63 



U indicates the bit is unassigned.and must be zero. 

indicates the bit is set to zero. 

1 indicates the bit is set to one. 



PROGRAM EVENT RECORDING MASK 
(Bit 1). 



TRANSLATION MODE (Bit 5). 



I/O MASK (Bit 6). 



EXTERNAL MASK (Bit 7). 



PROTECTION KEY (bits 8-1 1 ). 



EXTENDED CONTROL MODE INDICATOR 
(Bit 12). 



MACHINE CHECK MASK (Bit 13). 



WAIT STATE (Bit 14). 



PROBLEM STATE (Bit 15). 



CONDITION CODE (bits 18-19). 



PROGRAM MASK (Bits 20-23) 



INSTRUCTION ADDRESS (Bits 40-63). 



If ON, permits interruptions subject to the program-event 
register 9. 



control bits in control 



If ON, invokes the dynamic address translation (DAT) services. 



It ON, enables I/O interruptions subject to the channel mask bits in control 
register 2. 



If ON, enables external interruptions subject to the corresponding external 
sub-class mask bits in control register 0. 



Is compared with a storage key whenever a result is stored, or infornrration is 
fetched from a protected location. 



If ON, indicates that the supervisor operates in Extended Control (EC) model. 



If ON, enables machine check interruptions resulting from system damage or 
instruction-processing damage; other machine check interruptions are enabled 
subject to the sub-class mask bits in control register 14. 



If ON, indicates that the CPU is in the Wait State. 



If ON, indicates that the CPU is in the Problem State; if OFF, the CPU is in the 
Supervisor State. 



Is set as the result of the execution of certain instructions. 



comprises: 

Fixed-Point Overflow Mask 

Decimal Overflow Mask 

Exponent Underflow Mask 

Significance Mask. 

A Mask bit ON enables an interruption when the specified exception occurs. 

The Significance Mask bit also determines the manner in which floating-point 

addition and subtraction are completed. 



For all PSWs, the address is that of the next logical instruction. In addition, for 
the new PSWs the address points to the routine that handles the particular 
interrupt, and for the old PSWs it contains the return address in the 
calling routine. 
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Displacement 
in hexadecimal 


Description (all numbers referenced are in hexadecimal). 


0-7 


The field is used for the following two functions: 

Restart New PSW: The new PSW is fetched from locations 0-7 during the restart operation(Not used for DOS/VS.) 
IPL PSW: The first eight bytes read during the IPL initial read operation are stored at locations 0-7. The 
contents of these locations are used as the new PSW at the completion of the IPL operation. These locations 
may also be used for temporary storage at the initiation of the IPL operation. 


8-F 


The field is used for the following two functions: 

Restart Old PSW: The current PSW is stored as the old PSW at locations 8-F during the restart operation. 

(Not used for DOS/VS.) 

IPL CCW1 : Bytes 8-F read during the IPL initial read operation are stored at locations 8-F. The contents of these 

locations are ordinarily used as the second CCW in an IPL CCW chain after completionof the IPL initial read operation. 


10-17 


IPL CCW2: Bytes 10-1 7 read during the IPL initial read operation are stored at locations 10-17. The contents 
of these locations may be used as the third CCW of an IPL CCW chain after completion of the IPL initial read 
operation. After IPL bytes 14-17 contain the address of the background partition communication region. 
Thereafter they contain the address of the communication region for the active partition. (Communication 
regions are described in Section 4). 

In a system with VTAM, bytes 10 - 13 contain, after IPL, the address of the VTAM communications Vector 
Table (ATCVT). VTAM uses this table to obtain entry point addresses for VTAM modules. 


18-3F 


Interruption Old PSWs: The current PSW is stored as the old PSW at locations 18-1 F, 20-27, 28-2F, 30-37, and 
38-3F during the external, supervisor-call, program, machine-check, and input/output interruptions, 
respectively. 


40-47 


CSW : The channel status word (CSW) is stored at locations 40-47 during an I/O interruption. It, or portions 
thereof, may be stored during the execution of START I/O, START I/O FAST RELEASE, TEST I/O, HALT 
I/O, or HALT DEVICE, in which case condition code 1 is set. 


48-4B 


CAW: The channel address word (CAW) is fetched from locations 48-48 during the execution of START I/O 
and START I/O FAST RELEASE. 


4C-4F 


Save area for job duration measurement when the interval timer location is being used by the supervisor 
IT option routines. 


50-53 


Interval Timer: Locations 50-53 contain the interval timer. The timer is updated whenever the CPU is in the 
operation state. Depending on the resolution of the timer, the low-order locations may not be updated. 


54-57 


Contain the time of day. 


58-7 F 


Interruption New PSWs: The new PSW is fetched from locations 58-5F, 60-67, 68-6F, 70-77, and 78-7F 
during the external, supervisor-call, program, machine-check, and input/output interruptions, respectively. 


80-83 


The address of the system communication region, described in Section 4. 


84-87 


External-interrupt Code: During an external interruption in the EC mode, the interruption code is stored at 
locations 86-87 and zeros are stored at locations 84-85. 


88-8B 


SVC-lnterrupt Code: During a supervisor-call interruption in the EC mode, the instruction-length code is stored 
in bit positions 5 and 6 of location 89, and the interruption code is stored at locations 8A-8B. Zeros are stored 
at location 88 and in the remaining bit positions of 89. 


8C-8F 


Program Check Interrupt Code: During a program interruption in EC mode the instruction-length code is 
stored in bit positions 5 and 6 of location 8D,and the interruption code is stored at locations 8E-8F. Zeros 
are stored at location 8C and in the remaining bit positions of 8D. 


90-93 


Translation-Exception Address: During a program interruption due to a segment-translation exception or a 
page-translation exception, the translation-exception address is stored at locations 91-93, and zeros are stored 
at location 90. 


94-95 


Monitor-Class Code: During a program interruption due to a monitor event, the monitor-class number is 
stored at location 95, and zeros are stored at 94. This field can be stored in either the BC or EC mode. 


96-97 


PER-lnterrupt Code: During a program interruption due to a program event, the program-event-recording 
(PER) code is stored at location 96, and zeros are stored at 97. This field can be stored only when the 
instruction causing the PER condition was executed under the control of a PSW specifying the EC mode. 


98-98 


PER Address: During a program interruption due to a program event, the program-event-recording (PER) 
address is stored at locations 99-9B, and zeros are stored at location 98. 

This field can be stored only when the instruction causing the PER condition was executed under the control 
of a PSW specifying the EC mode. 


9C-9F 


Monitor Code: During a program interruption due to a monitor event, the monitor code is stored at locations 

9D-9F, and zeros are stored at location 9C. 

This field can be stored in either the BC or EC mode. 


BA-BB 


I/O Interrupt Address: During and I/O interrupt in EC mode the address of the interrupted 

device is stored in this field in the format Ocuu 

This field is also stored at IPL time to indicate the IPL device. 






'\ y 



^ 



Table E-2 Format and contents of low address storage. 
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FORMAT OF EC MODE PSW 


























U 


R 


U 


U 





T 


1 
O 


E 


Protection 
key 


1 


M 


W 


P 


U 


U 


C 


C 


Program 
mask 


Unassigned 


Reserved 


Instruction address 



LOW ADDRESS 
STORAGE 



These bytes may contain: 

I PL error codes during errors at I PL, or 
coded messages if an error occurs during normal 
program execution, and SYSLOG and SYSLIST 
are both inoperable, teee E-3 in this section). 



After I PL of a system containing VTAM, these four 
bytes contain the address of the VTAM communi- 
cations Vector Table (ATCVT). VTAM uses this 
table to obtain entry point addresses for VTAM 
modules. 

After I PL, these four bytes contain 
the address of the BG communica- 

tions region. Thereafter they 

contain the address of the commu- 
nications region for the active 
partition. 



o 





0000000000000 


ILC 





PROGRAM- INTERRUPTION 
CODE 



The format and contents of low address storage 



OEHUGEXI 



12/f>6/73 



FP REG 
CR 0-F 



OOOOMIB 0C04O910 00000049 00000102 
00000000 00000000 00000000 ♦00*007* 
COOOOOOO POOOOOOO COCOOOOO 000 30000 
004000FF OO0OE6*0 FFFFFFFF FFFFFFFF 
OOOOFFFF OOOCOOOO OOrOOOOO 00000000 
HI 4:)0I« IS OOP*»0 



oocoooze 00000000 

000410TA D7C8CIE2 
00000000 00000000 
OCOOOOOO OOOCOOOO 
00000000 IjOOOOOOO 



21.01.4S 

OOOOOOOC OOOCOOOO 

t00406EE 0n0422A0 

OOOCOOOO Of^COOOOO y . 

OOOCOOOO Aiwrnnrin ^f^/jff(^f^ 

c 2 ooaoo«-fl(Tt5520o 



nO00E769 08OO0OC0 



OOOOOOOO, lOjronnoo 



i 0004CO 



00050C 

ooqszoi 
oo<J5*35 

000$6Q 
000580 



o5o?TO" 

F1F261F0 
00060FFF 
41044296 
46 300100 

ooonroco 

1^0006140 
0001 7C00 
60900800 



CO0CE758 
O0CCP0''0 
P0O20007 
20onrQ60 



pocooooo?Tooi 

FBCC1900 04566168 
04080000 000CD13* 
1204200^ 00020000 

oooocouo oo"cinoo 




o/acU4k< x^&fH^^ 



l/TAM Arcvr 



I71D2000 00040084 
070C20OC O0C0O9OC 
040CCOCr OPfl10C14 
040COPOO OOOOOBIO 
OOOOQflOt OOOOOICC 

oooogooaU>ooo.oooo 



70C07000 
00342 \2F 
JFroiFOA 
JEBCOOIO 
00TO5H0 
0^040700 
00«002C 
00009260 



ov Iitt^!ie,o£iim. 



000 
0000( / 

jFoc.^r; 

00000010 
COC00340 
00004134 
OOOSOOOO 
00C05F78 



ocroso90 

40404040 
00CO26C4 
0000700C 
00006068 



000 
E03 
.4F0 
00007118 
40404000 
00004888 
00000000 
O0O06PCO 



C4C5C2E4 
3BA0CEDO 0C2E40FD 
0000JCD4 OOCOOOSt 
00003864 3B04SA30 
40404040 404040 )0 
00005854 OOCOa2E8 
00008299 0000608;8 
OOKOOlO OO0374BO 



s^^?;^ k'oo'-x'hf' ':::::::. 



0EBUGEX3 



jgjg' 



An example of a system dump printout, reduced in size, showing the address storage 
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WAIT STATE 
MESSAGES 



Bytes 0-3 of low address storage are used to store and record coded messages when 
a system malfunction occurs during IPL. Other occasions when coded messages are 
stored in these bytes are described below under 'Wait states during problem program 
execution'. 

Whenever a wait state occurs, it is imperative that these low address storage bytes are 
dumped by using the console printer ALTER/DISPLAY feature, described in D-1 of 
this section. The table below lists all the coded wait state messages: 






BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed in low address storage 


x'cr 


X'E2'{2) 


A, l,S(1) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'G3' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A, I.Sd) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A, I.SII) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A, 1, S(1) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; system codes in ECSW are invalid. 


X'C9' 


X'E2'(2) 


A, l,S(1) 


Not used 


Channel failure; channel address invalid. 


X'DI' 


X'E2'(2) 


AJ,S(1) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' Channel 


Unit or 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction. 








X'OO' 


Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 
issued. Re-IPL system. 


SDAID Hard Wait Code | 


X'6r X'E6'|3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready. Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO'O) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The following Hard Wait Codes are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CIL. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


•Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=!NJO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDIR canceled during system CIL update. 

If this occurs, the system CIL is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


X'OO' 


X'OO' 


X'OF' 


X'F5' 


TFIX count outside limits. 


X'OO' 


X'OO' 


X'OF' 


X'F4' 


$$A transient not found (the transient name can be found in ERBLOC). 


X'OO' 


X'OO' 


X'OC 


X'CC 


No recovery possible from CRT errors. 


Device Error Recovery Soft Wait Codes placed in low address storage. 


X'08' to 


X'Cr or 


Channel 


Unit 


Error recovery messages. Refer to chart E-3-F. 


X'60' to 


X'C4' 






■ 






Table E-3 Wait State codes 

Notes: 1. A (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 



2. S(X'Er) « Run SERE P. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 



^ 
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Wait states during IPL 

If the system enters the wait state during an IPL procedure and no message is 
printed on SYSLOG, the operator should record at least the first five bytes of low 
address storage. The IPL error message number and action code are displayed in 
hex in these bytes. For example: 

Message Oil 1 A appears in low address storage bytes 0-4 as 

F0C9F1F1C1 

The operator should look up this message in DOS/ VS Messages and perform the 
indicated action, except for the messages noted below. 

/PL error messages 

If there is an equipment malfunction during IPL, or the IPL cannot be loaded, an 
IPL error message is placed in bytes 0-3. In this state all interrupts are disabled, 
and you must repeat IPL after dumping low address storage, as shown in 
flowchart D- 1 -F in this section. 



Other Aids 

WAIT STATE 
MESSAGES 



ByteO 


Bytel 


Byte 2 


Byte 3 


Meanings: 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL input/output error: 

• I/O error on SYSRES 

• I/O error on communication device (see notes 1 and message X'F0C9F0F1' 
below) 

• Equipment malfunction during the STORE CHANNEL ID instruction 
(see note 2) 

• Supervisor entry not found. 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 16K of real storage is left for problem 
programs. Check that the correct disk volume is mounted on the device 
assigned to SYSRES and re-IPL. If the error recurs, the system programmer 
must check the allocations of real partitions specified in the supervisor to 
be used, and check that at least 16K of real storage is available for execu- 
tion of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FI' 


If a card reader has been assigned to SYSRDR during system generation 
and is to be the IPL communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation 
and yet it is to be the IPL communication device, simply READY the 
reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested can not be found. 
Check that the correct disk volume is mounted on the device assigned to 
SYSRES. If it is correct, re-IPL and specify a different supervisor when 
message 0I03A is issued and press the END/ENTER key, or press END/ 
ENTER key only, to load the standard supervisor. (If possible contact 
the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FI'- 
X'F3' 


X'FO'- 
X'F8' 


Refer to messages 0111 A - 01321 in IPL Messages in the 
DOSA/S Messages manual 




Note 1 : When the IPL procedure reaches the normal IPL wait state, and the IPL 
communication device is to be SYSLOG, press the REQUEST key on the console 
printer keyboard. 

Note 2: When byte 3 = X'OO', byte 2 indicates the channel for which the STIDC 
instruction was issued. 



Serviceability Aids 2. 1 9 3 



Other Aids 
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MESSAGES 



Wait states during program execution 

Three conditions will place a coded message in low address storage during program 
execution: 

• I/O device error 

• Hardware failures 

• Unrecoverable I/O error during FETCH. 






1 . I/O device error messages. 

Device Error Recovery Messages. 

The example below shows the information that is placed in low address storage 

bytes hex 0-3 when a wait state is caused by an I/O device error, and both 

SYSLOG and SYSLST are inoperative, or SYS LOG is not assigned. 

An example of a coded device error recovery message as it is stored in the low 

address storage is shown below: 

0P08A INTERVREQSYSLST=OOE 

An example of a device error recovery message is shown below: 




Refer to OP messages in DOS/VS Messages, 



Byte 


Byte 1 


Byte 2 


Byte 3 


X'08' to 
X'60' 


Action 
indicator 

'cr-'C4' 


Channel 


Unit 






If this condition occurs, the operator must dump, or display and note, bytes 0-3 
of low address storage, and inspect the contents of byte 0. This byte contains a 
hex number that corresponds to a OP message listed in DOS/VS Messages. 

Before proceeding with system operation, the operator will have to decide whether 
to continue system operations with the program currently running or to CANCEL 
all jobs and repeat IPL. This decision depends on system commitments and the 
importance of other programs that are running. 

To continue operations, the operator must first inspect the contents of byte 1 
for the presence of a hex CI or C4. The flowchart opposite shows what further 
actions can be taken under these conditions, and a flowchart in Section 3 indicates 
to operators when this procedure may be required. 



y 
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From Chart 03 
Section 3. 



WAIT STATE 
MESSAGES 



Byte 1 contains X'CV 



Byte 1 contains X'C4' 



Inspect bytes 2 and 3 
Byte 2 indicates the ciiannel, 
byte 3 indirates the unit. 



o 



Insert X'Or (RETRY) 
in byte 4, and press the 
INTERRUPT key 



E-3-F 



Yes 



Either; 

Perfornn any manual recovery procedures 

implied by the error conditions. 

(Refer to component desaiption and operating 

procedures manual for the device.) 

Ready the device and press the INTERRUPT key, 
or 

Cancel all jobs by inserting X'03' in byte 4, 

and press the INTERRUPT key. 




Either; 

Insert X'02' (IGNORE) 
in byte 4, and press the 
INTERRUPT key, 

or 

Insert X'03' (CANCEL) 
in byte 4, and press the 
INTERRUPT key 



System operation 
continues 



o 



Operator procedure to recover from an input/output device error, when the device 
error recovery message cannot be printed on either SYSLOG or SYSLST. 
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WAIT STATE 2. Hardware failure _ 

MESSAGES f \ 

If a hardware failure occurs that cannot be corrected by the RAS transients \^./ 

(R-transients), a message is normally printed on SYSLOG. If this is not 
possible a coded message is placed in low address storage, 

A value of X'EEEEEE' in the address part of the wait PSW indicates that an 
unrecoverable hardware error has occurred. 

A complete list of wait state messages is given in table E-3. 

3. Unrecoverable I/O error during FETCH 

If an unrecoverable I/O error occurs during a FETCH operation, a coded message is 
placed in the low address storage bytes 0-3. 



J 
> 
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A linkage editor map is an aid to program debugging. This map is obtained during 
link-editing when SYSLST is assigned (unless ACTION NOMAP was specified). 
Details about link-editing are found in DOS/VS System Control Statements. 



Other Aids 

THE LINKAGE 
EDITOR MAP 



o 



Description 

When used in conjunction with a storage dump and program listings, the linkage 
editor map will help in locating programs and subroutines that are included in the 
programs at object time. Common areas, load address, relocation factors, low and 
high addresses are also shown. In addition, the PHASE card is displayed to show 
where the phase was loaded, which is also helpful when working with multi- 
phase programs. 

The linkage editor map also shows where programs should' be located in virtual 
storage, where overlays are loaded, and whether the program is relocatable, self- 
relocating, non-relocatable or SVA-eligible. The example below shows a linkage 
editor map. 



■ 




HHHHH 


HHi 












HI 


HHHHH 




■ 


1 




12/06/73 PHASE 


XFR-AD 


LOCORE 


HICQRE 


DSK-AD 


ESD TYPE 


LABEL 


LOADED 


REL-FR 




■ 


■ 




PHASE*** 


040078 


040078 


0A232F 


047 13 3 


CSECT 


BEGIN 


040078 


03C878 RELOCATABLE 




■ 


1 














CSECT 
* ENTRY 


IJFFZZWZ 
IJFFZZZZ 


041E08 
041ED8 


041 E08 




1 


■ 














CSECT 


IJCFZIZO 


042230 


042230 




■ 


1 














CSECT 
* ENTRY 


IJOFCZZZ 
IJOFZIZZ 


0422AO 
0422AO 


O422A0 




1 


■ 












CSECT 


IJ2L0067 


0422F8 


0422F8 




■ 


■ 






















(^y 6o t^r) 


■ 


■ 




HHHH 


HI 












HI 


HHHHHl 




■ 




The next two illustrations show an example of the DIAGNOSTIC OF INPUT, 
and virtual storage MAP, which are printed on SYSLST during link-editing. 

The example contains errors which are discussed in the text following each figure. 



How to use 

Refer to A-2 in this section for an example that shows how the map is used during 
debugging in conjunction with a system dump and program listing. Examples at 
the end of this chapter show the information reports that immediately follow the 
map. These reports confirm that the new phase, or phases, are correctly cataloged, 
and enable you to monitor the status of your libraries. 
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THE LINKAGE 
EDITOR MAP 






JOB 

ACTION 

LIST 

LIST 



EXAMPLE 



12/25/75 



DOS LINKAGE EDITOR DIAGNOSTIC OF INPUT 



LIST 
LIST 



8 


LIST 


9 


LIST 


10 


21411 


11 


LIST 


12 


21311 


13 


LIST 


14 


LIST 


15 


LIST 



17 


LIST 


18 


LIST 


19 


LIST 


20 


LIST 


21 


21021 


22 


LIST 



TAKEN MAP CLEAR 

PHASE PHASE I.ROOT.NOAUTO 
INCLUDE ,(NAMEONE) 



21411 EX1 0002 ESD 404040 0010 0002 POINTS 1 000244 000003 NAMETWO 2 FF0130 OOOOCA NAMTHREE 000200 0000A8 



PHASE PHASE2,x,N0AUT0 
INCLUDE .(NAMEFOUR) 



21411 EX1 0002 ESD 404040 0010 0002 POINTS 1 000244 000003 NAMETWO 2 FF0130 OOOOCA NAMTHREE 000200 0000A8 

PHASE PHASE3,PHASE1+73,NOAUTO 
INCLUDE ,(NAMETWO,NAMTHREE) 

EX1 0002 ESD 404040 0O1O 0002 POINTS 1 000244 000007 NAMETWO 000130 001898 NAMTHREE 000200 0000A8 

INCLUDE RELMOO 

INCLUDE RELMOD 

EX1 0002 ESD 404040 0O1O 0002 POINTS 1 000244 000003 NAMETWO 000130 001928 NAMTHREE 000200 0000A8 

PHASE PHASE4,+ 16500 
INCLUDE RELMODUL 

21441 REL 0015 TXT 00425C 0O38 F0F1 1A361A56 46D0E254 4130EF1E D500EF1E E5FA477C E2869201 EF1E0630 9509EF1D 4770E286 



AUTOLINK AUTOMOD2 

PHASE PHASE5,+X'25BA',NOAUTO 
REP 0C4018 0OS41S0,C03A,47F0,C30E 
REP 0C40CC 003D20E, 



PATCH ASSEMBLY ERRORS 



REP 0C40CC CSFO OOOS D20EF0C5 6B404040 40404040 40404040 40404040 40404040 40404040 40404040 40404040 
ENTRY INVALID TRANSFER LABEL 



'v.,.y 



Line 1 (ACTION TAKEN). MAP and CLEAR have been specified on separate ACTION cards. Had NOAUTO, REL, CANCEL, 
BG, or Fn been specified, it would also appear on this line. 



Lines 4, 7, 10, and 13. Error 21411 (duplicated ESI D number) is printed four times because the submodular structure of the phase 
demanded four passes over the same module. As the linkage editor processes in its own input area, the record printed may not be 
identical to the original input record. Lines 10 and 13 differ in content from lines 4 and 7 for this reason. 



Lines 11 and 12. Line 1 1 is printed when the statement is read by the linkage editor. Line 12, error 2131! indicating that the 
requested module is not in the relocatable library, is printed after the error is detected. 



Line 16. This is an example of an error detected in a TXT statement. Error 21441 indicates that the ESID number F0F1 is invalid. (It 
should be binary 01.) 



Line 17. Indicates the AUTOLINK feature was used for relocatable library module inclusion in the phase named above it. 



Line 19. An example of a valid REP statement. 



Lines 20 and 21. An example of an invalid REP statement. Line 20 is printed when the statement is read by the linkage editor. 
Line 21, error 21021 indicating an invalid operand in the statement, is printed after the error is detected. 



When a module is included from the relocatable library, it is not possible to guarantee that the sequence identification printed in 
columns 8-15 is that of the record printed. This occurs because the MAINT librarian program reblocks the content of the cards to a 
more compressed format. 



y 
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THE LINKAGE 
EDITOR MAP 



1 


PHASE 


XFR-AD 


LOCORE 


HICORE DSK-AD 


ESD TYPE 


LABEL 


LOADED 


REL-FR 




2 


COMMON 








COM 




001800 


0000C8 




3 


ROOT PHASE1 


001 8C8 


001 8C8 


0019F7 013 2 2 


CSECT 


NAMEONE 


001 8C8 


0C18C8 


NOT RELOCATABLE 


4 










ENTRY 


POINT1 


001 8CC 






5 










* ENTRY 


P0INT2 


001930 






e 


PHASE 2 


001 9F8 


0019F8 


001 A87 013 3 1 


CSECT 


NAME FOUR 


0019F8 


0C1750 


NOT RELOCATABLE 


7 


OVEROOT PHASES 


0019E8 


001918 


001B1F 013 3 2 


CSECT 


NAMETWO 


001918 


001 7E8 


NOT RELOCATABLE 


8 










CSECT 


NAMTHREE 


O019E8 


0C17E8 




9 










* ENTRY 


POINTS 


001A2C 






10 










CSECT 


NAMEFOUR 


001A90 


0C17E8 




11 


PHASE4 


0043A0 


004140 


005gA3 013 4 1 


CSECT 


AUT0M0D1 


004140 


003A98 


NOT RELOCATABLE 


12 










ENTRY 


AUTOENT 


0042D0 






13 










CSECT 




0043A8 


0C3EF8 




14 










CSECT 


AUTOMOD2 


004SCO 


000X0 




15 


PHASES 


002688 


002688 


002767 013 6 1 


CSECT 




002688 


-001 BOS 


NOT RELOCATABLE 


16 










CSECT 


NAMES 


002688 


-001 BOS 




17 


•UNREFERENCED SYMBOLS 






EXTRN 


P0INT2 








18 










EXTRN 


POINTS 








19 


ROOT STRUCTURE OVERLAID BY SUCCEEDING PHASE 












20 


POSSIBLE INVALID ENTRY POINT DUPLICATION IN INPUT 
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INVALID TRANSFER LABEL ON END OR ENTRY STATEMENT IGNORED 










22 


CONTROL SECTIONS OF ZERO LENGTH IN INPUT 












23 


002 UNRESOLVED ADDRESS CONSTANTS 














24 


003 ADDRESS CONSTANTS OUTSIDE LIMITS OF PHASE 














Line 2 (COMMON). The entry under REL-FR cxsntains the length instead of the relocation factor in the case of ESD-type COMMON. 



Lines 5 and 9 (indicated by asterisks). These Entry labels (P0INT2 and POINTS) are not referenced as external symbols, that is, 
by corresponding EXTERN statements. 



Line 17 and 18. These labels indicate EXTERN or WXTRN references that cannot be matched with a corresponding entry point. 
In such a case *ENTRY ESD-types may be the corresponding, but misspelled, point. In the submodular structure, CSECTs not 
specified in any namelist appear as EXTERNs. 



Line 3, 6, 7, 11, and 15. All phase origins (entries under LOCORE) are incremented by the length of COMMON. 



Line 19. Warning message. When this message appears, OVEROOT is printed to the left of the name of the phase (PHASES) that 
overlays the ROOT phase. 



Line 20. Warning message. An entry label appeared at leiast twice in the input stream. At its second (or later) appearance, it was not 
possible to validate it as being a true duplication. T.he most common reason for this message is submodular structure with (source) 
ENTRY labels defined before the CSECT in which the entry point appears. 



Line 21 . An overriding transfer label in the ENTRY statement was not defined within the first phase, or a transfer label was not 
defined in an ENP statement in its module. 



Line 22. Warning nnessage. The COBOL, FORTRAN, RPG, and PL/i (D) compilers do not supply all of the information required 
by the lini<age editor in the ESD records. Specifically, the control section length is provided in the END record. If a control section 
defined in the ESD information has a length of zero, it norrrially_ indicates that the length is to appear in the END record. It is 
possible to generate zero-length control sections through assembler. Such a condition produces this message. This is not an invalid 
condition if it is not the last control section that is of zero length, if the last control section is of zero length, the length is implied 
to be in the END record and, if not present, causes an error condition. 



Line 2S. Total of unresolved address constants; may or may not include items from lines 17 and 18. Unresolved address constants 
will appear as zero RLD items in relocatable phases. 



Line 24. Address constants had load addresses outside the limits of the phase in which they occurred. This usually occurs if the 
control section length is incorrectly defined in the input. 



Serviceability Aids 2.199 



Other Aids 



THE LINKAGE 
EDITOR MAP 



^^.^> 




Status report after an update of a private core image library (SYSCLB), 




Status report after CATALR 




Status report after link-edit in system core image library. 



Note: Only the libraries that are affected are shown. 
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Other Aids 

Summary ^^^.V^^o^f.^^ 

EDITOR MAP 

The following list summarizes the information contained in the map. 

1. The name of each phase, the lowest and highest virtual" storage locations of 
each phase, and an indication if the phase is relocatable, non-relocatable, 
self-relocating or SVA-eligible. It also shows the disk address in hex where the 
phase begins in the core image library. 

2. An indication if the phase is a ROOT phase, or if a phase overlays the ROOT 
phase in any way (designated by OVERROOT). 

3. The length of COMMON, if appropriate. 

4. The names of all CSECTs belonging to a phase, the address where each CSECT 
is loaded, and the relocation factor of each CSECT. 

5. All defined entry points within a CSECT. If an entry point is unreferenced, it 
is flagged with an asterisk (*). 

6. The names of all external references that are unresolved. 

7. The transfer (execute) address of each phase. 

8. Warning messages are printed if: 

• The ROOT phase has been overlaid. 

• A possible invalid entry point duplication occurred. 

• The ENTRY or END statement contained an invalid (undefined) 
transfer label. 

• At least one control section had a length of zero. 

• The assembled origin on an RLD statement was outside the limits of 
the phase. 

• An address constant could not be resolved. 

These messages may or may not indicate actual programming errors. If NOMAP 
is operational, the warning messages are not printed. 
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General Description of RIVIS 

The need for the IBM serviceability aids that are collectively termed RMS (Recovery 
Management Support) has been described in Section 1 under the heading 
"Hardware Failures." 

RMS consists of softv/are routines that are grouped according to their function: 

• MCAR (Machine Check Analysis and Recovery) 

• CCH (Channel Check Handler) 

• ERP (I/O device Error Recovery Procedures) 

• RMSR (Recovery Management Support Recorder). 

Each function listed above is considered to be a function of RMS, and if required, 
must be included in your supervisor during system generation. The function RMSR 
consists of several recording facilities: 

• Unit check recording 
Machine check and channel check recording 
Tape/disk error statistics by volume 
MDR (Miscellaneous Data Recorder) 

IPL information 1 Reliability Data 

End of Day recording for devices and for the system. J Extractor (RDE) 

RMS is always supported on the Models 135, 138, 145, 148, 155-nyand 158, and the 
RMSR facihties supported depend on the paramters specified during system gene- 
ration. The parameters of the supervisor macros affecting the subjects described in 
this section are discussed here but further details required for generating a supervisor 
are found in the DOS (VS System Generation manual. 

System Requirements 

In order to perform its functions, RMS uses two logout areas contained in real 

storage: 

• The fixed logout area 

• The model-dependent log out area (not applicable to Models 1 15 and 125). 
As the name "model-dependent logout area" implies, the real storage area reserved 
for the logout areas varies for different System/370 Model types. Therefore, if 
you know during supervisor generation that the supervisor will be used on a larger 
model, specify the larger model in the MODEL = parameter of the CONFG super- 
visor generation macro. 

Because the Models 115 and 1 25 employ both software and hardware recording 
functions a more detailed description on these Models is given in the following 
paragraphs. For the Model 1 25, a hardware function records CPU and channel hard- 
ware failures on the console file. This also applies to hardware failures of natively 
attached I/O devices. Device ERP ist always supported for all models. When the 
Models 115 and 125 support channel attached I/O devices, or magnetic tape units, 
or teleprocessing, RMSR support must be generated during system generation. 
(RMSR support records unit checks on SYSREC.) RMSR support can be generated 
by either the parameter CHAN=YES, or RMS=YES, in the SUPVR system 
generation macros. 

When RMS=YES: hardware failures that occur on all attached I/O devices are 
recorded on SYSREC by the RMSR software routines. However no error recording 
occurs for the 2560 or 5425 if attached. Simultaneously the failures that occur 
on natively attached devices are also recorded on the console file by a hardware 
function. In the latter case of RMS=YES, MCAR/CCH records are recorded on 
SYSREC as well as on the console file, and the RDE facility is also supported. 






V y 



When RMS=NO and CHAN=YES: the supervisor generated supports RMSR 
(required for channel attached devices, tape units, and TP). Therefore, hardware 
failures on these devices are recorded on SYSREC by the RMSR software routines. 
When RMS=NO, CHAN=NO and MCH=NO: no recording occurs on SYSREC and 
a hard wait is entered on the occurence of a hardware failure. 
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Legend 






■•*- Data flow 

i*- Manual control 



Operator communications 



Notes: 

1. Not applicable to Models 1 15 and 125. 

2. Not applicable to Models 1 15 and 125 
that do not support the RMSR 
function. 

3. Use the U hardware command 
for a Model 115 or 125 that 

does not support the RMSR function. 



Hardware errors 



RMS 



CPU errors 



Hardware instruction retry 
(HIR). Error checking and 
correction (ECO 



Channel, control unit or 
device errors 



Use the MODE oomnnand to: 

• Set HIR or ECCto recording or 
quiet mode. (See note 1) 

• Change the error frequency limit, 
(EF L) threshold values for HIR 
and ECC. (See note 1) 

• Inquire about the status of 
present recording mode. (See 
note 1) 

• Set the recording mode for tape 
error statistics (TES) recording. 
(See note 2) 

Change type of recording for 
a specific device. (See note 2) 





Machine check 

and 

input /output 

interrupts 



Hardware control 



Software control 



Messages printed on SYS LOG or 
displayed on DOC inform operator 
of a hardware failure. 



System 
diskette on 
console fWe 



I I m m m 

Error 
Data 
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(Model 11 5/1 25 only) 



Recovery Management Support (RMS) 

• Check severity of the error 

• Attempt recovery from the error 

• Record the error on SYSREC 

• Print informative messages on SYSLOG. 



Issue ROD command at 
system switch-off , or at end of 
shift, or end of day. (See note 3). 
IP L reason information 
(See note 2) 



Messages on SYSLOG inform 
ofjerator about status of 
SYSREC, (Full, overflow, etc.) 



fO 



System 
recorder 

file. 
SYSREC 



EXEC EREP. Initiated by job 
control statement. 



Select Svstem/370 EREP options 
by controlstatements. 



f 

I 



No recording on SYSREC 
occurs on Models 1 1S »nd 
125 when RMS » NO 



System/370 EREP 



** System/370 EREP options. 
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RMS Operation 



An understanding of the purpose and operation of RMS will help when '"^^^j^ 

interpreting the EREP printout and the System/370 Models 115 and 125 
Maintenance Log Analysis Feature. 

The following four figures show the relationship between the hardware and 
software recording facilities, and show the connection between the system diskette 
(Models 1 15 and 125 only), the SYSREC file, and the EREP options. 

Figure F-l-A shows the types of machine checks generated and the real storage 
used for the logout areas. Error information is first logged in this area before being 
used by the RMS software routines. On the System/370 Models 1 15 and 125, 
the logout area is replaced by the system diskette recording file. 

Figure F-l-B describes the division of machine check interrupts into soft machine 
checks and Figure F-l-C illustrates the general flow of processing after a hard 
machine check occurs. 

Figure F-l-D expands the RMS routines into: 

• MCAR 

• CCH 

• Channel check ERPs that are initiated by CCH routines for device-dependent, 
channel error recovery. 

• Unit check ERPs that handle the unit check conditions of the devices. 

This figure also shows how the errors are first checked for their severity, and shows 
how the effect on system operation depends on the type and severity of the error. 

Figure F-l-E shows the types of records that are recorded on SYSREC. 

Figure F-l-F represents the EREP options that can be selected by the operator. / '^ 
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Storage 

error 

corrected 



X 



Input/output 
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device failures 



Storage 

error 

uncorrected 



CD 
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day clock 
damage 



TD 
Timer 
damage 



Key in 
storage 
uncorrected 
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PD 
Instruction 
processing 
damage 



SR 
System 
recovery 



ED 
External 
damage 



SD 
System 
damage 
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I/O interrupts 



Hard machine check interrupts 



Soft machine check interrupts 



For the Models 11 5, 125 
and 1 58 log out areas 
are replaced by the system 
diskette in the console file. 



Figure F-l-A illustrates how data about a hardware error is logged in 
fixed areas of real storage, or on the system diskette. 
This data in real storage is used by software routines for error recovery 
(where possible), and for recording the data on SYSREC. 



wiNi 



PSWs, CSW, CAW 
timer 



I/O communications 
area 



Fixed logout 
area 



CPU extended 
logout area 



Extended channel 
logout area 
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Soft Machine Check Interrupts 
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CPU retry 
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ECC single4Dit inter- 
mittent processor 
storage correction 
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T 
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External Damage 
(Not applicable to 
Models 1 1S and 125} 



For a Model 1 15 or 125 that does not 
support the software MCAPt/CCH, a 
coded message is placed in general 
register 1 l(X'B') and low address 
stOf»ge and system operation is 
terminated. 



Interval 

timer 

damage 



Time of Day 
Clock dannage 



Log status and 
record report 
on SYSREC 




Inform operator 
of action; 
continue processing 



Only applicable 
to the Models 
115 and 125 
if RMS=YES 



Figure F-l-B. General flow of DOS/VS MCAR processing after soft machine check interrupts 
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Figure F-l-C. General flow of DOS/VS MCAR processing after hard machine check interrupts 
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Not applicable to Models 115 and 1 25 



I/O control 
unit or 
device errors 
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CPU 
errors 
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Main storage or 
control storage 
errors 



HIR 







ECC 



Automatic retry and correction 
procedures by hardware 



Generate machine 
check interrupt 




Automatic System Action 



No 



• Save data about 
the error in register 

• continue processing 
in a degraded mode 



I/O control 
unit or device 
errors 



Main storage or 
control storage 
errors 



MCAR 
CCH 
ERP 
RMSR 



TES 



Accumulate 
Device status 
Data in PUB2 



Record PUB2 
counter infor- 
mationfordevice 
onSYSREC, if 
counter overt low 
or IPL/EODor 
ROD command 




Machine Check Analysis Recovery 
Channel check Handler 
Device Error Recovery Procedures 
Recovery Management Support Recorder 
(For Models 1 15 and 125, RMSR is only 
required for channel attached devices, 
TP, and tape units. For natively attached 
devices, recording is via hardware) 
If RMSR is present, recording is done 
for all devices. 
Tape Error Statistics. 

Automatic System Action 



Attempt to record data about 
the error on SYSREC 



• Attempt to print a message 
on SYSLOG 

• Place system in hard wait 



Yes 



Yes 



Record data about the error 
on SYSREC 



Print message on SYSLOG 
Terminate job in which 
error occurred 
Continue processing 
with next job 




Record data about the error 
onSYSREC 



Print message on SYSLOG 
Terminate job in which 
error occurred 
Continue processing with 
next job 



Record data about the error 
onSYSREC 



Print message on SYSLOG 
Continue processing the job 



Figure F-l-D Illustrates the connection between hardware error detection 
and software routines that enable data about the error to be recorded. It 
also shows the system action taken, depending on the type of error. 



Record data about the error 
onSYSREC 



• Print message on SYSLOG 

• Continue processing the job 
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MCAR/CCH 



Unit check 



Counter 
overflow 



IPL/EOD 



SYSREC** 



Miscellaneous 
data record 
(MDR) 



System 
Recorder File 
(Can be either 
on SYSRES or 
on a separate DASD) 



Tape error 
statistics (TBS) 



Teleprocessing 
error records 
(TPER) 



*For the Systenn/370 Models 1 15 and 125 the operator 
must save the disk usage counters at the end of the day, 
(or end of shift or prior to system switch off) by using 
the U command of the mode select display. 

** For the Models 115 and 125 recording on SYSREC is 
applicable only when the RMSR function is generated. 

Figure F-l-E Input records to SYSREC. 



EREP 

(Not applicable to Models 1 15 and 125 
not supporting RMSR function) 

EREP options: 




Edit and print the entire SYSREC file 



Selectively retrieve records from the 
SYSRECfileor History/RDE tapes 
for editing and printing 



Edit and print tape error data on 
the SYSREC file 



Summarize the SYSREC file 
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tapes 
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Statistic tape 



Summarize tape error data from 
SYSREC to the TES tape 



Clear the SYSREC file 
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option 



L 






RDE=Reliability Data Extractor 
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Figure F-l-F Output from SYSREC. 

(Selected by EREP options.) 
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Components 

The software routines required to support the RMS options are: 

• Resident MCH 

• Resident CCH 

• Resident RAS monitor 

• Resident DASD ERP 

e Device ERP transients (A transients) 

• MCH/CCH transients (R transients) 

• RMSR transients (A and R transients). 

To record tape and disk error statistics by volume, the option RMSR also uses 
some B transients. A job control module is required to enable RMSR to record 
IPL/EOD data. 

The figure below shows the relative locations, in the real address area, of the 
RTA (RAS transient area), LTA (Logical transient area), and FT A (Physical 
transient area). 

Note: No error recording or recovery can be executed before IPL is successful. 
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For the Models 115 and 1 25 the model- 
dependent logout area is replaced by 
the console file 
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Check/Channel Check function). 
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Note: Not applicable to 
the Models 115 and 125 



Note: There is no need for 
software control or EFL 
forHIR on the Models 115 
and 125 



Detailed Description of RiVIS Functions 

Machine Check Analysis and Recovery (MCA R) 

Two hardware error recovery features, Hardware Instruction Retry (HIR) and 
Error Checking and Correction (ECC), perform hardware correction for machine 
malfunctions. RMSR interfaces with the error correction hardware through 
Machine Check Analysis and Recovery (MCAR). 

When the CPU is in the 'recording mode,' MCAR is informed when a machine 
malfunction occurs and is corrected by means of a 'soft' (or recovered) Machine 
Check Interrupt (MCI). When the CPU is in 'quiet mode' the hardware correction 
routines do not generate a soft MCI if the malfunction is corrected. If the hardware 
correction routines cannot correct the malfunction, a 'hard' (or unrecoverable) 
MCI is generated regardless of the mode setting . 

When a soft MCI occurs, RMSR writes a record in the recorder file containing 
identification information and the contents of the machine-independent logout 
area and the machine-dependent logout area (if available). The operator is 
notified that a soft MCI occurred, control is returned to the interrupted code, and 
system operation continues. 

Dynamic Reallocation of Partition or page pool (DRAP): When a hard MCI occurs, 
the MCAR routine attempts to isolate the failure to a partition in order to cancel 
the damaged task and, if possible, continue system operation. If the system cannot 
continue because the failure occurred in an area critical to system operation, 
recording is attempted, after which the system enters a hard wait state. 

When a hard MCI is caused by an unrepairable real storage position, MCAR 
dynamically reallocates storage. Informative messages are printed on SYSLOG 
that alert the operator of any action taken by DRAP. 

MCAR Modes of Operation: An Error Frequency Limit (EFL) algorithm prevents 
SYSREC from filling up too quickly if a large number of intermittent failures 
occur. The initial IBM-supplied EFL is either eight (Models 155-11 and 158) or 
sixteen (Model 145/148; eight for control storage and eight for processor storage) 
soft ECC MCIs within an eight-hour period. These values are set at system gene- 
ration time and can be changed by the MODE command. A message is issued on 
the first occurrence of a soft MCI on a System/370 Model 135/138 and all 
recoverable machine checks are disabled. The MODE command must be issued 
to re-enable reporting of soft machine checks. These values are set at system 
generation time but can be changed by the MODE command. 

MCAR supports EFL for two hardware facilities: 

• Hardware Instruction Retry 

• Error Checking and Correction. 

EFL Threshold Values: At IPL time, the EFL threshold values are established so 
that the EFL algorithm controls the number of soft MCIs recorded. These 
values are : 

• The number of soft MCIs 

• A specific time period. 

When these EFL values are reached, a change in moderof operation occurs. Until 
the EFL threshold values are reached, the system operates in recording mode. 
This is the normal mode of operation in which an MCI occurs for all machine 
check conditions. After the EFL threshold values are reached, ECC (or ECC and 
HIR) is placed in quiet mode. In quiet mode, no MCIs occur for recovered errors; 
therefore, the number of corrected errors is unknown. 

EFL threshold values are not applicable to the Models 115 and 125 owing to the 
recording of errors by a hardware function. 
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Hardware Instruction Retry (HIR) Modes: The two HIR modes are: RMS 

• Recording. A soft MCI occurs for every hardware instruction correction. 

• Quiet. No soft MCI occurs for hardware instruction correction. (Recording 
is always quiet for Models 1 1 5/1 25.) 

Error Checking and Correction (ECC) Modes: The ECC modes are: 

• Recording. A soft MCI occurs for every main or control storage correction. 

• Quiet. No soft MCI occurs for real or control storage correction. (Recording 
is always quiet for Models 1 15/125.) 

• Threshold (Model 145/148 only). A soft MCI occurs after a predetermined 
number of unrecorded control storage errors have occurred within a given 
time period. Threshold mode is a hardware function and is not affected by 
EFL threshold values. 

If HIR is in quiet mode, ECC is also in quiet mode. When ECC is in quiet mode, 
HIR can still be in recording mode. 

At IPL time the system assumes the IBM-suppUed EFL threshold values; these 
values can be changed by the MODE command. When IPL is completed: 

• For the Model 145/148, recording mode is entered for HIR, quiet mode is 
entered for main storage ECC, and threshold maide is entered for control 
storage ECC. 

• For the Models 1 55-11 and 158, full recording mode is entered for both 
HIR and ECC 

Channel Check Handler (CCH) 

When a channel check occurs, channel error information is logged and an interrupt 
is generated. The CCH resident program investigates the severity of the malfunction. 
If the severity is such that system operation need not be immediately terminated, 
the CCH resident program: 

• Builds the Error Recovery Program Interface Bytes (ERPIB) containing 
error information for use by the appropriate CCH/ERP 

• Records the error information on the recorder file 

• Attempts to isolate the error to a device. 

If the error cannot be isolated to a device, CCH cancels all problem programs that 
use the malfunctioning channel. If the error can be isolated to a device and the 
device is supported by a CCH/ERP, the appropriate CCH/ERP is loaded into the 
R-transient Area (RTA). Then ERP examines the ERPIB supplied by CCH and 
determines the severity of the error. Whenever possible, the failing channel 
command is retried. If the command cannot be retried, or if retry fails, a message 
is written on SYSLOG, and all problem programs using the failing device are 
cancelled. If recovery is successful, a message is also written on SYSLOG, unless 
SYSLOG was the failing device. Certain retry conditions require manual operator 
intervention to enable proper retry. 

Note: If the 'accept unrecoverable error' bit in the CCB is on, the error is posted 
and control is returned to the problem program. 

If no CCH/ERP is available for an error isolated to a device, all problem programs 
using that device are cancelled. 
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Each I/O device or class of I/O devices has a unique device error recovery routine. 
The appropriate routine is entered from the channel scheduler upon detection of 
an error. The function of the error recovery procedures (ERP) is to attempt 
recovery from the error either through programmed recovery or by operator 
intervention. If recovery is not possible, the following choices are available, where 
apphcable: 

1. The error can be ignored. 

2. The task can be terminated. 

3. The problem program can take action (exit to a user routine). 

4. The record in error can be bypassed. 

Depending on the type of error, the type of device, and whether Logical IOCS 
is used, some or all of these options are available. Choices 3 and 4 are available 
through LIOCS only. In the absence of any other options, only choice 2 is 
available. 

At the time the error is first detected, before ERP is called to attempt recovery, 
RMSR accumulates certain information relating to the status of the device in the 
PUB2 for the device. The device ERP then gets control and tries to correct the 
error. If the ERP cannot recover, RMSR builds and writes the unit check record, 
containing the statistical data from the PUB2 and the status and sense information 
at the time the ERP determined the- error was unrecoverable. If the ERP recovers, 
the statistical data in the PUB2 is not cleared. This information is recorded at the 
next permanent error for that device, at the next statistical counter overflow for 
that device, or at end-of-day when the operator issues the ROD command. 

Besides the unit check record (written for every permanent error) and the counter 
overflow record (written when a statistical counter becomes full or when the 
operator issues the ROD command), RMSR also writes Tape Volume Dismount ( j 

I records and Miscellaneous Data Recorder (MDR) records. The data recorded in the " 

Tape Volume Dismount records corresponds to the data formerly accumulated in 
the TEBV table; the EREP TES (Tape Error Statistics) options are used to format 
and summarize this data. 
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%. SYSREC (System Recorder File) 

The recorder file must be created and assigned to a disk device that is always on 
line. It is assigned after IPL, before the first job. 

The recorder file is not CPU or SYSRES dependent. Thus it can contain records 
from more than one DOS/VS system. 

Once the file is created, no further operator intervention is required, unless the 
recorder file is damaged or the operator action listed in the DOS/VS Messages 
manual specifically requests the file to be re-created. For example, message 

0T03I ERROR ON RECORDER FILE. 
On subsequent IPLs the system opens the recorder file and continues to update it. 

Note 1 : Recording on the recorder! file is suppressed during execution of the 
EREP program. 

Note 2: No recording is performed for console typewriters and unsupported 
devices. 

Creating the Recorder File: The method of creating SYSREC and the job stream 
needed depends on whether the file is to be part of the system residence unit 
SYSREC, or whether it is to reside on a separate disk volume. 

For details and job stream examples, refer to Xhe DOS I VS System Management 
Guide. 

SYSREC Record Types: SYSREC contains variable-length records with a maximum 
size of 200 bytes (including a standard 24-byte header). The types of recording 
that RMSR performs are: 

• MCAR recordings 

• CCH recordings 

• Unit check recordings 

• Counter overflow recordings 

• Tape volume statistics recordings 

• IPL/EOD recordings 

• Miscellaneous Data Recorder (MDR) recordings 

• Teleprocessing error records (TPER). 

MCAR: Formats an environment record (recovery report) after a machine 
check. 

The record is written on the environment recorder data set (ERDS), which has 
the symbolic name SYSREC. The record contains the following pertinent 
information about the error: 

Status information from the fixed logout area in real storage 

Recovery action 

Program identification 

Date 

Time of day. 

CCH: Formats an error information block for use by the ERP routines after an I/O 
interrupt, caused by a channel check. 

The record is written on SYSREC, and contains the following information: 

• Status information from the logout area 

• The ECSW (extended channel status word) 

• Date 

• Time of day. 



Hardware Error Recording and Recovery 

RMS 

Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 
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RMS UNIT CHECK RECORD: Device ERPs attempt recovery from an error, usually lif~\ 

by retrying the failing channel command. If the error is not corrected after a 
certain number of retries, RMSR writes a unit check record which contains 
hardware information (sense data), statistical data, and identification data. All 
information relevant to the status of the device at the time the failure is recognized 
as permanent is contained in this record. One unit check record is written for each 
permanent error. RMSR resets the statistical counters in the PUB2 table at the 
same time. 

If message 0P43D is issued, a unit check record with sense byte of is written 
on SYSREC to reflect the occurrence of a tape volume change. 

COUNTER OVERFLOW RECORD: Whenever a statistical counter in the PUB2 
table fills up, a counter overflow record is written on SYSREC. The counter 
overflow record is also written for each device that has unrecorded statistics when 
the operator issues the ROD command. The statistical counters in the PUB2 table 
for the device are cleared at the same time. 

IPL/EOD: I/O error logging for System/370 users includes RDE (Reliability Data 
Extractor). If ERRLOG=RDE is specified during system generation, RDE gathers 
hardware reliability data that IBM personnel use to evaluate hardware performance. 

Two types of records are written on SYSREC by RDE: 

• An IPL record. This specifies the reason for IPL. 

• An EOD (End-of-Day) record. This is initiated by the ROD command, 
which should be issued before the system is shut down. 

EREP uses these records to identify RDE data. 

For the System/370 Models 115 and 125 the operator must save the disk usage /^ 

counters at the end of the day (or end of shift or prior to system switch-off) by ^ 

using the U command of the mode select display. 

MISCELLANEOUS DA TA RECORDER (MDR): ElMSR makes recordings on the 
SYSREC file for the 321 1 printer buffer errors; the 3330, 3340, and 3350 Disk 
Storage errors; the 3895 predictor sense information; and for those devices having 
an internal error log. 

TAPE VOLUME DISMOUNT RECORD: When processing standard labelled tapes 
using LIOCS, RMSR makes a recording on SYSREC each time a new volume serial 
number is detected. When the tape is opened, the number of the current tape is 
compared with the serial number in the PUB2 for that tape drive. If the serial 
numbers are different, a volume dismount record, containing volume usage and 
Tape ERP recovery statistics, is written on SYSREC. The statistical counters in the 
PUB2 relating to usage and error recovery action are cleared and the serial number 
is updated. Processing continues and statistical data for the new tape is accumulated 
in the PUB2 table. 
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TES (Tape Error Statistics) RMS 

A major factor affecting the quality of an operating system is the condition of the 
volume stored on a magnetic medium, such as tape. Such a medium is subject to 
contamination from dust, foreign materials, fingerprints, and particles of oxide 
coating. 

Because of these environmental factors, it is desirable to record the number of 
read and write errors occurring on each tape volume. By monitoring the error 
rate, a report can be kept on the condition of each tape volume in a tape library. 

System Requirements: For Tape Cartridge Readers. When error statistics are 
required to monitor tape cartridges used on the 2495 Tape Cartridge Reader 
specify TEE = n in the FOPT macro, (n specifies the number of tape cartridge 
readers attached to the system.) 

For magnetic tape volumes when error statistics are required to monitor tape 
volumes, specify TEVB=IR or CR in the FOPT macro. 

For all standard labeled tapes, tape statistics are accumulated by volume. For 
unlabeled and nonstandard labeled tapes two types of error recording are 
available: 

• Combined Recording (CR) 

• Individual Recording (IR). 

When TEBV=CR is specified, the error statistics for all unlabeled and nonstandard 
labeled tapes on a specific tape unit are accumulated until a labeled tape is 
mounted and opened on that unit. Then, one recording for the unlabeled and 
nonstandard labeled tapes is made, and the counters are reset in the PUB2 table. 

Specify TEBV=IR to record tape error statistics on the SYSREC file and to reset 
the PUB2 table counters at each OPEN for unlabeled and nonstandard labeled 
tapes. 

The mode of recording for nonstandard labeled and unlabeled tapes can be 
changed with the tape options of the operator's MODE command. 




Serviceabihty Aids 2.2 1 7 



Hardware Error Recording and Recovery 



RMS 



Not applicable to the 
Models 115 and 125 
using a supervisor 
that does not support 
the RMSR function 



EVA (Error Vo/ume Analysis) 

This option of RMSR enables you to specify the number of temporary read/write 
errors that can occur on a tape volume before an informatory message is printed 
on SYS LOG. 

System Requirements: The number of temporary read/write errors needed to 
print the informatory message must be specified by EVA=r and/or w the FOPT 
macro during system generation, (r specifies the threshold level of temporary read 
errors, and v^ specifies the threshold level of temporary write errors.) 

Description and operation: The message that EVA issues to SYSLOG contains the 
number of temporary read errors, temporary write errors, and START I/Os, the 
physical unit identification, and if standard labeled tape is used, the volume serial 
number. 

The message format is: 

4E10I xxxxxxcuu TR-nnn TW-nnnSIO-nnnnn 

where: 

xxxxxx Serial number of standard label volume (blank 

when nonstandard or unlabeled volume is 

being used) 
cuu Channel/unit address (physical unit) 
TR-nnn Number of temporary read errors 
TW-nnn Number of temporary write errors 
SlO-nnnn Number of START l/Os. 

Either the TR=nnn or the TW=nnn field contains one or more than the 
predetermined error threshold specified in the FOPT macro. 



How and when to use: When using an unlabeled or nonstandard labeled tape, a 
note can be made of the volume identification of the volume in use when the 
message is received in order to monitor it. 

By monitoring your magnetic tape volumes, a record can be accumulated of 
read/write errors per volume. 

Operational delays caused by old or worn tapes can be avoided by cleaning and 
erasing the volume, or by cutting off the first ten yards of the volume that indicates 
read/write errors. 

Note: The first part of a tape volume contains label information and is the part of 
the tape that suffers more from mechanical friction. Therefore, the oxide coating 
is more likely to cause read /write errors on the first part of a tape than on any 
other part. 
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Operator commands for controlling RMS 



RMS 



The error recording facility is under the control of the operator. In addition to 
creating the recorder file (SET RF=CREATE) and responding to error messages, 
the operator has the following responsibilities: 

• Matching PUB2 space to devices attached 

• Issuing the ROD command in response to the problem determination action 
of an error message, or prior to turning the system off or performing a 
re-IPL 

• Providing IPL reason information (RDE users only) 

• Issuing the MODE command to set the type of recording accomplished by 
the MCAR/CCH, CE, and tape error statistics portions of RMSR 

• Executing the EREP program and directing EREP to perform the correct 
function. 



^ 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 



r> 



The following sections describe these items more fully. 

Matching PUB2 space to devices attached to the system 

During IPL, the following message may be issued: 

01291 INSUFFICIENT PUB2 SPACE AVAILABLE, RE-IPL 

IPL is automatically canceled, and during the re-IPL the operator must delete 
devices until the above message is no longer issued. 

The reason for this message may be a change in system configuration since 
supervisor generation, or it may be that the supervisor in use has not been 
generated for the same amount and type of disk and tape devices. PUB2 (a table 
in the supervisor) contains a counter for statistical data on device operation and 
is used by the RMSR routines. 

Parameters of the lOTAB supervisor generation macro increase the size of PUB2 
to accommodate the counters for devices attached to your system that require a 
larger field than the standard 12-byte PUB2 field. 

The PUB2 table is described in more detail in the DOS/VS Supervisor Logic manual. 

IPL/EOD (End-of-Day) recording 

This RMSR 'facility enables data to be recorded on the system recorder file 
(SYSREC) about the reason for, and time between, operator IPLs. 

This allows IBM and installation management to monitor IPLs for any selected 
time period, for example, during an 8 hour operator shift. 

When RDE is required, specify ERRLOG=RDE in the SUPVR macro during 
system generation. 







The ROD command (Record on Demand) 

Using this command will ensure that any statistical data held in the PUB2 table 
is added to the recorder file. For System/370 RDE users, the ROD command also 
writes the EOD (End-of-Day) record on SYSREC. MDR records are produced for 
those devices with an internal error log. The command ROD has no operand. 
BTAM and QTAM use their own separate methods of updating all disk counters 
during closedown or cancel. 

For the System/370 Models 115 and 125, the operator must save the disk usage 
counters at the end of the day (or end of shift or before system switch-off) by 
using the U command of the mode select display. 
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Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 



When to use: 

1. Operator actions listed under appropriate messages in DOS /VS Messages 
indicate when to issue this command. 

2. In order to create meaningful END-OF-DAY records on the system recorder 
file, you must respond with y to the message END-OF-DAY= at system 
shutdown or at the end of every shift. 

(If the END-OF-DAY record is not required, respond with n to the END-OF-DAY= 

message.) 

/PL reason information 

During the processing of the first // JOB statement after IPL, RDE users must 
provide additional information about the system. Message 1I89A IPL REASON 
CODE= is issued on SYSLOG. You must respond to message 118 9 A with a Reason 
Code followed by End. 

If a Reason Code is not entered (only the END key is pressed) or if SYSLOG is 
down or not assigned to a 3210, a 3215 or a Model 125 video display unit, then 
the default, DF, is assumed. However, if an invalid code is entered, message 1I92I 
is issued and message 1I89A is reissued until a vahd response is made. 

After the Reason Code is entered, message 1191 A SUB-SYSTEM ID= is issued. 
You must respond to message 1191 A with one of the ID codes followed by END. 
The ID codes further identify the reason for performing IPL. The ID codes and 
the reasons are shown in the table below. 



IPL REASON CODE 

CE 



DF 
EN 



IE 



IM 



ME 



NM 
OP 



UN 
UP 



IBM CE/SE has control of the system 

and is not doing user work. 

Default. 

Environmental problem (such as; power, 

overheating, etc.) caused failure. 

IBM hardware or a IBM-supplied-program 

error that did not require an IBM CE/SE. 

IBM hardware or IBM-supplied-program 

error that required an IBM CE/SE. 

Media. Hardware error caused by a faulty 

disk jaack, reel of tape, cards, etc. 

Normal IPL. 

Operational problem. Operator error 

or procedural problem. 

Unknown. Undetermined error. 

A user (non-1 BM-supplied) program caused 

the failure. 



SUB-SYSTEM ID 

00 Unknown. Must be used with Reason Codes DF, EN, NM, OP, UN and UP. 

00 is the default. 
10 Processor. CPU, channel (integrated), storage unit, etc. failure. 
20 DASD. A failure occurred in a DASD unit or its associated control unit 

(2311, 2314, 2319, 2841 , 3330/3333, etc.) 
30 Other. A device without an ID code (such as a paper tape unit) caused the 

failure. 
40 Magnetic Tape. A failure occurred in a magnetic tape unit or its associated 

control unit (2400, 3400, etc.) 

50 A failure occurred in a card reader /punch, a printer or in its associated 
control unit (2540, 3525, 1403, 2821, etc.) 

60 MICR/OCR. A magnetic ink character reader (1412, 1419, etc.) or an optical 
character reader (1285, 1287, 1288, etc.) failure. 

61 Inscriber. A 3895 Document Reader/I nscriber failure. 

70 A teleprocessing failure occurred in a teleprocessing control unit 

(2701,2702, 3705, etc.) 
80 Graphic. A video display unit (2260, etc.) or its associated control unit 

failure. 

90 An IBM-supplied SCP Type 1 or Type 2 program (such as the DOS/VS 
system or one of its components) failure. 

91 An IBM Programming Product failure. 






Table F-2-A IPL reason codes 



If the ID code is not entered (only the END/ENTER key is pressed) or if SYSLOG 
is down or not assigned to a 3210, a 3215 or a Model 125 video display unit then 
the default, 00, is assumed. However, if an invalid ID code is specified, message 
1I92I is issued and message 1191 A is repeated until a vaUd response is made. 

Notes: 

1. Always use ID code 00 with Reason Codes DF, EN, NM, OP, UN, and UP. 

2. ID codes 10, 20, 30, 40, 50, 60, 61, 70, 80, 90, and 91 should be used with 
Reason Codes CE, IE, IM, and ME. 

Normal processing continues after the IPL information has been specified. In order 
to create meaningful data on average running time per IPL, you must issue the 
ROD command before the system is shut down at the end of the working day, or 
at the end of a shift. By this procedure, an accurate record can be maintained on 
the system recorder file, which is printed periodically using an EREP option 
explained later in this section. 
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The MODE command 

This command should be used only at the request of your IBM customer engineer, 

CR 
CE,cuu 



RMS 



MODE -< 

J 



Not applicable Aw 
to the Model 125 W 



,1 [,xx,y] 

,D[,xx,y] 

,N 



R 

STATUS 
HIR 
ECC 



•X- 




[,E=eeee] [,T=tttt] 






*Note: When either HIR or ECC is specified, at least one of the optional operands 
within these braces must be selected. TH is only valid for the Model 145 or 148 
when ECC,C is specified with the MODE command. 

The mode command provides the following options for controlling RMSR: 

• Reset the recording mode for unlabeled and nonstandard tapes, 

• Set recording mode for a particular device to intensive, diagnostic, or no 
mode. 

• Initiate or suppress HIR (Hardware Instruction Retry) and ECC (Error 
Correction Code) error recording, 

• Request the Mode that the system is operating in (the status of the system). 

• Change the mode of operation from Q (quiet) to R (recording) or from 
R to Q. 

• Specify EFL threshold value to override the IBM-supplied value. 

• Race the Model 145 or 148 Control Storage ECC in threshold mode. 

The MODE command is a notational command. Operands of the MODE command 
can be entered in any order and must be continuous with no blanks between or 
within operands). The STATUS operand cannot have any other operands before 
or after it. 

The total length of the MODE command must not exceed 30 characters. 

The table below describes the parameters for the MODE command: 




Note: Not applicable to the 
Models 115 and 125 using a 
supervisor that does not support 
the RMSR function. 



Note: Not applicable to the 
Models 115 and 125. 



Operand 


Description 


IR 
CR 


Recording mode for nonstandard labeled and unlabeled tape. Specify Individual Recording (IR) if you wish to record 
and then reset the tape error statistics at each tape OPEN. Specify Combined Recording (CR) to accumulate all the 
statistics from nonstandard labeled and unlabeled tape on a specific tape unit until a standard labeled tape is opened. 
Then one recording of the statistics from all the nonstandard labeled and unlabeled tapes is made on SYSREC, and 
the statistical counters are reset in the PUB2 table. 


CE 


The recording mode for a device at physical location X'cuu' nrtay be reset. The possible recording modes are: 

b Normal. The default, normal, is assumed. 

1 Intensive. Normal recording continues. In addition, the next seven errors of a particular type (xx,y) or the next 

seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries required for success is 

also recorded. 
D Diagnostic. Normal recording continues, in addition, the next seven errors of a particular type (xx,y) or the 

next seven errors of any type (if xx,y is not specified) are recorded. The number of I/O retries riequired for 

success is also recorded. 
N No recording. 

When the recording mode parameter is the last parameter of the MODE command, a check is made to see if all errors 
are recorded. When in intensive or diagnostic mode, it is possible to check for only one type of error. Indicate the 
bit to be examined with: 
(xx,y) where y is the bit (0—7) and xx the byte (0—31 ) of sense data to be checked. 



Table F-2-B Parametets for the MODE Command (part 1 of 2) 
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Operand 


Description 


STATUS 
Not applicable* 
to Models 1 15 
and 125 


On SYS LOG a report is printed which indicates: 

• The type of facility used (HIR,ECC) 

• System mode of operation 

• Current error count 

• Error count threshold 

• Current elapsed time 

• Time threshold 

• Number of buffer pages deleted. 
The status report formats are: 

TrI 

HIR,. V,aaaa/eeee,bbbb/tttt 
For the Model 135 or 138: 

For the Model 145 or 148: 

R M 
ECC, Q, C^aaa/eeee,bbbb/tttt 
For the Models 1 55-1 1 and 1 58 : 

ECcJ \ ,aaaa/eeee,bbbb/tttt 

BUF DLT=XXX 

where: 

aaaa = Current error count 

eeee = Error count threshold 

bbbb = Current elapsed time 

tttt = Time threshold 

XXX = Total number of inoperable buffer pages deleted. 


HIR 

Note applicable 
to Models 1 15 
and 125 


Hardware Instruction Retry. This operand changes the mode of the HIR facility to R or Q and/or modifies 

the error count threshold and/or time threshold. 

Note: When HIR is placed in quiet mode, ECC also goes into quiet mode. 


ECC 

Not applicable 
to Models 1 15 
and 125 


Error Correction Code. This operand changes the mode of the ECC facility to R or Q, and/or modifies the 
error count threshold and/or time threshold. ECC,R and ECC.Q are the only valid modes of diagnosis for the 
Model 135 or 138. If ECC is specified for a Model 145 or 148, M or C must also be specified. ECC can also 
place the Model 145 or 148 control storage in threshold mode. 

Note: Use of the Error Correction Code (ECC) in full recording mode may cause severe system degradation. 
Thus, the (ECC, 'M/C,R) operand combination of the mode command should only be used by the customer 
engineer or at his request. 


R 


Recording Mode 

MODE R - places both HIR and ECC in recording mode. 

MODE HIR,R - places HIR in recording mode. 

MODE ECC,M,R(Model145or148)— if HIR is already in recording mode.mainstorageiis placed inirecording mode. 

MODE ECC,C,R (Model 145 or 148)- if HIR is already in recording mode, control storage is placed in 

recording mode. 

MODE ECC,R (Models 155-11 and 158) - if HIR is already in recording mode, it places ECC in 

recording mode. 


Q 

Not applicable 
to Models 1 15 
and 125 


Quiet Mode 

MODE HIR,Q- places both HIR and ECC in quiet mode. 

MODE EEC.Q (Model 135, 138, 155-11 and 158) places ECC in quiet mode. 

MODE ECC,M,Q (Model 145 or 148) — places main storage in quiet mode. 

MODE ECC,C,Q (Model 145 or 148) — places control storage in quiet mode. 


More 

Note applicable 
to Models 1 15 
and 125 


Main or control storage: M or C is only valid for the Model 145. 
M or C must be specified when ECC is specified for the Model 145. 
M indicates main storage and C control storage. 


TH 


Threshold Mode: on the next occurrence of an ECC control storage error, control storage is placed in quiet 
mode. TH is only valid for the Model 1 45 or 1 48 if ECC,C is specified. TH places the Model 1 45 or 1 48 
control storage ECC in threshold mode. 


E=eeee 
T=tttt 


Values entered for E and T must be within the following decimal ranges: 

E— 8 (initial value) through 9999 (Error Count threshold) 

T-8 (initial value) through 9999 (Time threshold) 

The IBM-supplied value is 8. 

Note: Whenever HIR is in quiet mode, ECC mode must not be changed. 

For the Model 135 or 138, the only valid mode commands are: 

MODE CE„.. 

MODE STATUS 

MODE ECC,Q 

MODE ECC,R 
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Table F-2-B Parameters of the MODE Command, (part 2 of 2). 
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The EREP program edits and prints error statistics records that have been stored on 
the recorder file (SYSREC) by RMSR. 

System Requirements 

Before it can be executed, EREP must be cataloged to the core image library. 
Check with the person in your installation who is responsible for creating or 
maintaining the core image library to ensure that the EREP program is cataloged. 
The link-edit statements for cataloging EREP are in the DOS /VS System Generation 
manual. 



EREP 



Note: Not applicable to the 
Models 115 and 125 using 
a supervisor that does not 
support the RMSR function. 



The EREP program is a modular, self-relocating program. It can run in a real 
or virtual partition using standard job control statements. When the environmental 
data is needed or the SYSREC file becomes full, EREP can be executed from 
SYSLOG or SYSIPT. 






EREP can perform any combination of the following options: 
Edit/print the entire SYSREC file 
Create or update the history/RDE tapes 

Selectively retrieve records from the SYSREC file or history/RDE tapes 
for editing and printing 
Summarize the SYSREC file 
Create or update a TES history tape 
Edit/print TES data from the SYSREC file 
Summarize TES data from the SYSREC file or history tape 
Clear the SYSREC file. 

Tables F-3-A and B show how the options are selected and table F-3-C lists the 
logical unit assignments required by EREP. Table F-3-D and the text following 
gives a detailed description of these options. Flowchart F-3-F shows the procedure 
for executing EREP. 
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OPTION' 




OPTION TES 



[,NEW] r,PRINT[,SUM[,SUMTAPE]] [,VOL]] 
[,SUM[,SUMTAPE] [,VOL] J 

,NOTAPEy,PRINT[,SUM[,SUMTAPE] ] [,VOL]\ 
VSUM[,SUMTAPE] [,VOL] / 



Table F-3-A. The options for TES (Tape Error Statistics) 



DISK 

DISKETTE 
TAPE 
MICR/OCR 
GROUP='<UNITREC 
^TP 
CPU 
2715 
ALL 



CPU=xxxxxx,yyyv 

where xxxxxx = the CPU volume serial 
number 
yyyy ~ the CPU model number. 






Table F-3-B. Parameters for the SUM option. 



LOGICAL UNIT 


COMMENTS 


SYSIPT 


Optional 


SYSLOG 


Required, must be assigned to a 3210, 3215 or 
a Model 1 25 video display unit 


SYSREC 


Required 


SYS007 


Optional; must be assigned to a magnetic tape unit 
when a TES option is specified. 


SYS008 


Optiortal; required for TES options. 
Must be assigned to a magrietic tape unit. 
Used as a work tape. 


SYS009 


Optional; must be assigned to a magnetic tape unit 
for history /RDE options. 



Table F-3-C. Logical units required by EREP. 
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OPTION 


RESULT 


OPTION EDIT 


Edits and prints SYSREC onto SYSLST. 


OPTION CLEAR 


1 . Edits and prints SYSREC onto SYSLST 

2. Clears SYSREC. 


OPTION SU 

GROUP= < 
CPU=xxxx> 


M 

DISK 

DISKETTE 
TAPE 
MICR/OCR 
UNITREC 
TP 
CPU 
2715 
^ALL 

X, yyyy 


> 


Prints the summarization of SYSREC onto SYSLST. The file is summarized by the 
hardware group(s) listed in the GROUP parameter. 

If records from multiple CPUs appear on the SYSREC file, specify the serial number 
(xxxxxx) and model number (yyyy) of the CPU whose records you wish to have 
summarized. If CPU data is not supplied, records from all CPUs appearing on the 
SYSREC file are summed together. 


OPTION HIST,NEW[,2] 


1. Creates the history /RDE tape on SYS009 (see note 1) 

2. Clears SYSREC. 


OPTION HIST[,2] 


1 . Updates the history /RDE tape on SYS009 (see note 1 ) 

2. Clears SYSREC. 


OPTION HIST, UPNEW 


1. Updates the history/RDE tape on SYS009 (see note 1 ) 

2. Creates a new tape file on SYS009 
3 Claars SYSREC. 


OPTION EDIT 

followed by 

OPTION HIST.NEW or OPTION HIST 


1 . Edits and prints SYSREC onto SYSLST 

2. Creates or updates the history/RDE tape on SYS009 (see note 1 ) 

3. Clears SYSREC. 


OPTION TES.NEW 


Creates a TES history tape on SYS007. 


OPTION TES 


Updates a TES history tape on SYS007, 


OPTION TES,NOTAPE,PRINT 


Edits and prints tape error data from SYSREC onto SYSLST. The data is printed in 
the detail tape unit format. 


OPTION TES,PRINT,NEW 


1 . Creates a TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES.PRINT 


1 . Updates the TES history tape on SYS007 

2. Edits and prints tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 


OPTION TES,NOTAPE,SUM 


Prints the summarized tape data from SYSREC onto SYSLST in the detail tape 
unit format. 


OPTION TES,NOTAPE,PRINT,SUM 


1 . Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
tape unit format. 

2. Prints the summarization of the tape data from SYSREC onto SYSLST in the 
summarized tape unit format. 


OPTION TES,SUM,VOL 


1 . Updates the TES history tape on SYS007 

2. Summarizes the tape error data on SYSREC by volume serial number. 


OPTION TES.PRINT, VOL 


1. Updates the TES history tape on SYS007 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format. 


OPTION TES,PRINT,SUM,SUMTAPE,VOL 


1. Updates the TES history tape on SYS007. 

2. Edits and prints the tape error data from SYSREC onto SYSLST in the detail 
volume serial number format 

3. Summarizes the tape error data on the history tape and prints it on SYSLST 
in the summarized volume serial nurhber format. 


OPTION TES,NOTAPE,SUM,SUMTAPE 


Summarizes the tape error data on the history file and prints it on SYSLST in the 
summarized tape unit format. 


OPTION SELECT (see note 2) 


Selectively prints records from SYSREC onto SYSLST. 


OPTION SELECT,TAPE (see note 2) 


Selectively prints records from the history/RDE tape onto SYSLIST (see note 1 ). 


OPTION RDESUM 
(none) 


Summarizes the IPL, EOD, MCAR, CCH, and Unit Check records for a specified 
period of from one to 30 days. These records are on the history/RDE tape 
(see note 3). 

Edits and prints SYSREC onto SYSLST. 


Notes: 

1. RDE is only available if ERRLOG = RDE is specified at generation time. 

2. Records are selected b y specifying select parameters. 

3. RDESUM does not summarize across multiple volumes. If EOF is encountered before the entire requested reporting period 
has been covered (this can be checked through the end data printed on the RDESUM listing), rerun RDESUM using the next 
volume history /RDE file and the same reporting period you specified during the first RDESUM execution. A listing with 
the remainder of the requested information is thus generated. 
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Table F-3-D. The EREP options 
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EREP Description of EREP Options 

EDIT 






The EDIT option causes EREP to edit and print the contents of the SYSREC 
file on SYSLST. The unit check records are displayed first and are grouped by 
CUA (channel and unit address) v^ithin each device group (unsupported, tape, 
disk, TP, unit record, MICR/OCR). 

After the unit check records, the channel check, machine check, 2715, and 
IPL/EOD records are displayed. Retain these printouts for problem determination. 

EREP displays IBM 2715 error records from the SYSREC file in this order: 

1 . Disk adapters 

2. 2790 loop adapter 

3. MPX adapters 

4. 2750 adapters. 

5. BSC adapters. 

The special code records are grouped for editing and printing by area station 
address, CUA, and special code. All area station records on SYSREC are 
summarized by device address, area station, ID, and CUA during editing and 
printing. 

EREP EDIT will run in the minimum virtual partition of 64K. If it is executed 
in real mode, the minimum useable partition size is lOK, but this will result 
in a performance degradation, as phases will have to be overlaid. 

CLEAR: The CLEAR option causes EREP to clear (reset) the entire SYSREC file 

for RMSR recording. If the CLEAR option is specified by itself, the EDIT option 

is forced. CLEAR is always the last EREP function performed. CLEAR is forced 

if HIST, or HIST with optional parameters, is specified. li ^' 

Note: If a hard I/O error occurs on SYSREC while the CLEAR function of EREP 
is running^ EREP will abnormally end and the operator should re-IPL the system. 
In a MPS system, it may be undesirable to re-IPL. If you do not re-IPL, however, 
the contents of the SYSREC file will be unpredictable. If a unit check record has 
the channel status "device not operational', the CSW is deleted to avoid editing 
an invalid CSW. 

SUM 

The SUM option allows hardware groups on SYSREC file to be summarized. 
This function can: 

• Accumulate certain bits and bytes in CPU logouts within MCAR/CCH 
records. Not appHcable to Models 115, 125, and 155. 

• Accumulate statistical and sense byte data from unit check and MDR records 

• Summarize area station data in 2715 error records by device address, area 
station, ID, and channel and unit address. 

The SYSREC file may be summarized, or one or more hardware groups may be 
summarized. The GROUP parameter must be punched in a new card immediately 
following OPTION SUM. 

'disk 

DISKETTE 

TAPE 
^r,^,.., J MICR/OCR 
GROUP= ^ UNITREC 

TP 

CPU 

2715 

These entries, separated by commas, may be made in any order. If the GROUP 
parameter does not follow OPTION SUM or if it contains an error which the 
operator does not correct, the EREP program summarizes the SYSREC file for 
the tape hardware group. 



o* 
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If the SYSREC file contains records of multiple CPUs, the CPU whose records are 
to be summarized must be defined by entering 

CPU = xxxxxx,yyvy 

in which xxxxxx = the CPU serial number 
yyyy = the CPU model number. 

If no CPU is provided, records from all CPUs appearing in the SYSREC file are 
summed together. 

You can execute the SUM option more than once during an EREP run if you 
enter the option and parameter control statements via SYSLOG. After the 
summary is performed with one set of parameters, the message 

3E05A ENTER SUMMARY PARAMETERS 
is printed on SYSLOG. You may enter the parameters for another summary at 
this time, or end execution of the SUM function by responding with CANCEL 
and pressing the END or ENTER key. 

If GROUP=ALL is specified, EREP does not ask for additional parameters because 
a summary of all records is made. 

The 3895 Document Reader/Inscriber is included in the MICR/OCR group for 
summary purposes. 

Tapes and disks are summarized per CUA in chronological sequence as recorded 
on SYSREC. The records are summarized for: 

2400 tape series up to 16 different CUAs 
3400 tape series up to 1 1 different CUAs 
2300 disk series up to 16 different CUAs 

3300 disk series up to 17 different CUAs for unit check condition record formats 
and up to 8 different CUAs for other record formats 

The CUAs are the normalized addresses, which means that if fixed addresses 
are used, the real address is the normalized address, and, if plug-in addresses 
are used, drive A resolves to address or 8, drive B to address 1 or 9, etc., 
and drive H to address 7 or F. 
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When the summary has been completed, EREP processes the next option, if any. 

It is possible to reduce the processing time for the SUM function by allocating more 
main storage (in blocks of 8K) to the partition in which EREP is to run. The root 
phase requires 2K and each transient 8K. The diskette and 2715 groups each use 
one transient; TP uses three transients; all other hardware groups use two transients. 

When 2715 is specified in the GROUP parameter, the 2715 records are summarized 
before any other hardware group. The 2715 group uses lOK of storage, even if 
more storage is available. If not all the 27 15 records can be processed in the lOK 
partition, those that can be are processed, after which the transient is reloaded, and 
the next 27 1 5 records are processed. This is done until all 27 1 5 records are 
processed. 

In the 8K partition, the TP group can process records for up to 60 distinct 
tenninal names at one time. If more than 60 terminals are to be summarized, the 
file must be read more than once. If more than one hardware group is specified 
in a 1 OK partition, the transients overlay each other and the file must be read as 
many times as there are transients. 



Note: This applies only to 
EREP executed in real mode. 
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SELECT 

By means of the specified search parameters, EREP selects records to be printed. 
The SELECT option initiates the search for these records on SYSREC; for 
example, SELECT, TAPE causes a search of the history tape to be performed. 
The parameters of the SELECT option are called select parameters; they are 
checked for validity but not for logical relationship. For example, although an 
MCAR record has no VOL field, the parameters 

TYPE=MCAR 
VOL= 123456 

are considered valid. 

The possible select parameters are listed in the table below: 






SELECT PARAMETER 


RESULT 


CPU=xxxxxx 


All error records associated with a CPU may be selected for printing by enterihg the 
six digit CPU serial number. 


TYPE= H 


'MCAR" 

CCH 

IPL 

EOD 

TP 

UNIT 
.2715 J 


•- 


A specific type of error record may be selected for printing. Any number of different 
types, separated by commas, may be selected for each search. If TYPE=UNIT is 
selected, all error records except volume dismount records are handled. 


fyyddd.yyddd L 
^A"r^" jyyddd ( 


All recordings made within a time span (measured in days) may be selected for printing. 
If two dates, separated by a comma, are specified, all recordings made in that time span 
are selected. If only one date is specified, all recordings made on that day are selected 
for printing. 


TIME hhmm,hhmm 


All recordings made within a time span (measured in hours and minutes) may be 
selected for printing. 


JOB=xxxxxxxx 


All recordings made during the execution of a specific job may be selected for 
printing by specifying the eight-byte jobname from the job statement. 


VOL=xxxxxx 


The error records for a specific volume may be selected for printing by entering the 
six-byte volume serial number. 


TERM=xxxxxxxx 


The error records for a terminal may be selected by entering the eight-byte terminal 
name. 


CUA=xxxx 


Records may be selected for printing by entering the channel and unit address 
(in hexadecimal) or the line number for TP. CUA=normalized address. 


DEVICE=xxxxxx 


The records associated with a specific type of device may be selected by entering the 
device type code (for example, 1403, 1442N1). 

To retrieve records associated with 3340 model 70 enter 334A. To retrieve records 
associated with 3330 Model 1 1 enter 3330B. 


FORMAT=TES 


Whenever a tape (2400 or 3400-series) error record is encountered, it is printed in the 
detail TES format by volume serial number. If FORMAT=TES is not specified, all 
tape error records are printed in the unit check format. All error records except 
volume dismount records are handled. 


Tare A " 
sel2715= j adapter 
[special 


- 


The 2715 records are printed in area station format if the SEL2715 parameter is not 
specified. If printing by area, adapter, or special is required, however, the SEL2715 
parameter must be specified. 






Table F-3-E. The select parameters. 



You may enter any combination of parameters on separate cards or lines; the EREP 
program assumes that you will only enter select parameters that apply to the records 
you want. If no select parameters are specified with the SELECT option, the MCAR 
records are selected and printed. 

The SELECT option can be executed more than once during an EREP run if the 
option and parameter control statements are entered via SYSLOG. After selective 
retrieval, when one set of select parameters has been conipleted, the message 

3E03A ENTER SELECT PARAMETERS 

is printed on SYSLOG. At this time, you may enter a new set of select parameters 
to execute the selective retrieval or you may end selective retrieval by responding 
with CANCEL and pressing the END or ENTER key. 
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The RDESUM option provides a summary of information about system operation 
during a specified 1 to 30 day period. This summary is created by searching the 
history/RDE tape, mounted on SYS009, for IPL, EOD, MCAR, CCH, and unit 
information provided by the RDESUM option includes: 
« The starting and ending dates of the report. 

• The date, time, reason, and subsystem responsibiUty for each IPL. 

• The average run time between IPL and EOD (or between two consecutive IPLs 
if the ROD command was not issued to create an EOD record) for the 
specified interval. If specified, the number of IPL records that occur in the 
cluster interval, (see note) . 

• The subsystem responsibility and number of times a subsystem caused a 
System Recovery Incident (a recoverable error that may cause system 
degradation) or a System Incident (an unrecoverable error that caused 
system failure). 

• If the history/RDE tape contains no records within the specified dates, an 
error message is printed and the report is terminated. 

• IPL records are not counted in the reports of sub-systems SI (System 
Recovery Incidents) 

• If an IPL record with a reason code of UN, IE, IM, ME or DP is immediately 
preceded on the tape by an SRI that occured within 30 minutes of the 
IPL, the SRI may be reclassified as an SI. The SRI is reclassified if (1) the 
subsystem ID specified for the IPL is the same as the device type of the SRI, 
or (2) if the subsystem ID is unknown (00). 

• Multiple SRIs on the same device are counted as a single SRI until there is a 
ten minute interval without an incident or an IPL record. 

• If an SI occurs within ten minutes of the IPL record following an SI, the SI is 
counted as a multiple occurrence of the first SI regardless of the subsystem 
involved. Intervening SRIs are ignored. 

• If 1 6 sequence errors occur on the history/RDE tape, RDESUM is 
terminated; if fewer than 16 sequence errors occur, the out-of-sequence 
records are ignored. 

Note: Clustering is the process of searching for multiple IPL records that have 
occurred within a specified number of minutes. Qustering can be used to detect 
multiple false starts that may distort other information provided by RDESUM. 

RDESUM is executed when the appropriate option card is encountered. The control 
information, including the start date for the report, the end date, the clustering 
interval if clustering is desired, and the company name, is entered once the 
EREPRDE phase is in main storage. The control information is entered in response 
to prompter messages. 

RDESUM does not summarize across multiple volumes of a history/RDE file. If 
EOF is encountered on the input tape, RDESUM goes to EOJ and the report 
printed reflects the information available from the start date to the last record 
on the tape. There may be some inaccuracy in the average run time per IPL 
(because RDESUM does not know when the EOD or next IPL record will occur, 
it uses the time of the last error record to compute the IPL period), but no other 
information is lost. 

RDESUM can be executed again for the next volume in the history/RDE file to 
obtain the remainder of the information for the desired reporting period. The 
previously specified period may be used on the subsequent volume because 
RDESUM starts with the first record on the tape if the specified start date is 
earlier than the date of the first record. 
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E R E P The following rules govern the method for summarizing RDE information: 

• If the history/RDE tape does not contain information for a portion of the 
required time period, only those dates on the tape that fall within the time 
period are processed. The actual dates processed aie reflected on the 
summary listing, 

• If the starting date is defaulted, the first record on the tape is used to start 
the report. The report is stopped with the specified end date or, if that date 
is more than 30 days from the date of the first record processed, the 
thirtieth day processed. 

• If the end date is defaulted, the report is stopped with the last date on the 
tape or, if that date is more than 30 days from the starting date, on the 
thirtieth day processed. 

H/S T or HIS T with Operands 

This option copies the data on the SYSREC file to the history/RDE tapes. All 
records on the tape(s) appear in chronological order. If an unrecoverable I/O 
error occurs while a record is being read from the SYSREC file, the record is 
ignored and processing continues with the next sequential record. If the data fills 
the complete tape, the message 

3E15A TAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG. The operator must mount a new tape and press END to 
continue processing, or he may respond with CANCEL and press END to cancel 
the HIST option. 

The tape must be mounted on SYS009, which must be assigned to a tape drive 

before EREP is executed. The tape contains standard labels that are checked 

before the history/RDE tape is written. If the wrong tape is mounted, the message /T^ "\ 

3E31A WRONG TAPE, MOUNT CORRECT TAPE ^X.J 

is printed on SYSLOG. Mount the correct tape and press END to continue 
processing, or respond CANCEL END to cancel the HIST option. When the HIST 
option is specified, the CLEAR option is forced. The SYSREC file is cleared 
after the history/RDE tape has been created or updated, thus preventing 
redundant data from being transferred to the history/RDE tape the next time the 
HIST option is executed. 

HIST,NEW,(,2): This option causes EREP to create a history file on the tape unit 
assigned to SYS009. If 2 is also specified, a second history file is created on the 
same tape unit for RDE data. The tape(s) contain the contents of the SYSREC file. 
The SYSREC file is cleared after ail options have been executed. 

HIST, UPNEW: This option causes the tape file mounted on SYS009 (either 
history or RDE) to be updated, after which a new tape file is created. If UPNEW 
is specified, TLBL information for creation and updating must be included in the 
job stream. The SYSREC file is cleared when all options have been executed. 



J 
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The TES options provide for the editing and printing of the tape error records on 
SYSREC and the summarizing of tape data found on either SYSREC or the history 
file. 

To enable this option to be used a work or scratch tape must be mounted on a tape 
unit assigned to SYS008 . This option can also select tape error data from the 
SYSREC file and create a TES history tape with the same format as the previously 
supported ESTV tape file. All records on the tape appear in chronological order. If 
an unrecoverable I/O error occurs while reading a record from, the SYSREC file, 
the record is ignored and processing continues with the next sequential record. If 
the data fills the complete tape, the message 

3E15A TAPE FULL, MOUNT NEW TAPE 

is printed on SYSLOG, The operator must mount a new tape and press END, or he 
may respond CANCEL END, the latter response causes tape updating to be 
discontinued, but TES records are still printed. 

The TES history tape must be mounted on SYS007, which must be assigned to a 

tape drive before EREP is executed. The tape contains standard labels that are 

checked before the TES history tape is written. If the wrong tape is mounted, the 

message 

3E31A WRONG TAPE, MOUNT CORRECT TAPE 

is printed on SYSLOG. Mount the correct tape and press END to continue processing, 
or respond CANCEL END to cancel the TES option. The history/RDE tape and 
TES history tape should be created or updated during the same EREP run. If the 
HIST option specified without the TES option, the SYSREC file is cleared after 
HIST has been executed,and the TES data is lost. If you wish to maintain both 
these history tapes and the TES and HIST options are not specified together in 
one EREP run, the data on the TES history file may be redundant or lost. 

TES,NEW: This causes EREP to create a TES history file on the tape unit 

assigned to SYS007. The tape file contains tape error data from the SYSREC file. 

The tape error data on the tape has the same record format as the previously 

supported ESTV tape file. Use ESTVUT utility program to print this tape file. 

TES: EREP updates the TES history tape on SYS007. 

TES,NOTAPE,PRINT: Causes the tape data on SYSREC to be edited and printed 

on SYSLST. Data is printed in the detail tape unit format. 

TES,PRINT,NEW: A new TES history tape is created on SYSOe?^ after which the 

tape error data on SYSREC is edited and printed on SYSLST. The data is printed 

in the detail tape unit format. 

TES,PRINT: The TES history tape, which is mounted on SYS007, is updated. , 

The tape error data on SYSREC is then edited and printed on SYSLST in the 

detail tape unit format. 

TES,NOTAPE,SUM: The tape error data on SYSREC is summarized by tape drive. 

TES,NOTAPE,PRINT,SUM: The tape error data on SYSREC is edited and printed 

on SYSLST in the detail tape unit format. Then the tape error data on SYSREC is 

summarized by channel and unit and printed on SYSLST. 

TES,SUM,VOL: The TES history tape on SYS007is updated. Afterwards the 

tape error data found on SYSREC is summarized by volume serial number. 

TES,PRI NT,VOL: The TES history tape mounted on SYS007 is updated. The 

tape error data on SYSREC is edited and printed on SYSLST in the detail volume 

serial number format. SYS008 is used as a work tape and the detail records are 

printed in sequence by volume serial number. 

Four examples of processing tape error statistics using EREP are given in 
Appendix J. 
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There are three types of EREP history tapes: the History tape, the RDE tape, and 
the TES history tape. The History and RDE tapes are created and updated from the 
SYSREC file and contain all the record types found on the SYSREC file. The TES 
history tape is also created from the SYSREC file, but contains only tape error 
records. If your installation has the History/RDE tapes and a TES history tape, you 
should create (or update) all the history tapes in the same run. If this procedure is 
not followed, the TES history tape may have redundant or missing data. 

Retain the History and TES history tapes for those persons who work on problem 
determination. The History tape can be used as input for certain online test 
programs of OLTEP. (See the OLTEP manual.) The TES history tape can be printed 
with the ESTVUT utility program. Retain the RDE tape; it will be used by IBM. 

History/RDE Tape 

The History and RDE tapes are created and updated using the EREP history option. 
RDE information is only available if ERRLG=RDE is specified at system generation. 
A magnetic tape unit assigned to SYS009 must be used for these functions. EREPNEW 
must be the filename that is used when a tape is created, and EREPUP when a tape 
is updated (both TLBL cards must be included for UPNEW). When the tape becomes 
full or when a second tape must be mounted, the operator is notified via SYSLOG. 

Note: If EREP is linfc-edited as a self-relocating program, a LBL TYP card is 
needed when EREP builds a history /RDE tape. 

TES History Tape 

The TES history tape is created and updated using the EREP TES options. A ,^ A 

magnetic tape unit assigned to SYS007 must be used for this function. The filename \^ 
of the tape file must be TAPEIN when the file is created and the file is updated. 

Creating the History Tapes 

You can create a history tape only if DOS/VS has recorded errors on SYSREC. 
The EREP program allows you to create or update the three types of history tapes. 

You can create the History/RDE tape by specifying OPTION HIST, NEW, and 
update it by specifying OPTION HIST. 

If a System/370 RDE tape is to be processed, the message 3E16A is printed on 
SYSLOG after the History tape is written. This message instructs you to replace 
the History tape reel with the RDE tape reel and then respond to the message. A 
response of END will cause the RDE tape to be processed and response of CANCEL 
END will cnacel only the HIST option. Any other response will cause the system 
to reissue message 3E16A. 

In addition, you can create a TES history tape, which contains only tape error 
records. If you want to maintain a TES history tape, create (or update) it in the 
same EREP run in which you create (or update) the History/RDE tape. You can 
create the TES history tape by specifying OPTION TES, NEW, and update 
it by specifying OPTION TES. 
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Processing the tape error statistics with EREP 

The EREP (Environmental Recording, Editing, and Printing) program provides 
processing options for thie tape error statistics records on SYSREC. 

Tape records can be edited and printed or summarized, together with the order 
records on SYSREC; you may also choose to have only the tape error records of 
the file selected or summarized. If the SYSREC file has been used to create a 
history/RDE tape, the records on that tape contain the same information as the 
SYSREC file contained. In this case the tape error statistics records can be selected 
or summarized from the history/RDE tape file. 

The SYSREC file may also be used to create a TES history tape. This tape contains 
tape error statistics records only. These records have the same format as the 
records of the former ESTV disk file; thus only part of the information recorded 
on the SYSREC file for tape error statistics is written on the TES history file. The 
information written on the TES history file consists of: 

Date the record was collected 

Physical address of the device on which the tape volume was mounted 

Number of temporary read errors 

Number of temporary write errors 

Number of permanent read errors 

Number of permanent write errors 

Number of error gaps encountered 

Number of noise blocks encountered 

Number of cleaner actions taken 

Number of SIO instructions issued 

Volume serial number if the tape was a standard labeled volume 

Block length if the volume contained fixed-length blocked records 

Tape density of the tape volume. 
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The history /RDE tape and the TES history tape must always be updated in the 
same run. Failure to update both these tapes on the same run may result in 
redundant or lost data on the TES history tape. When PRINT is specified, the 
detail records on SYSREC are printed on SYSLST. When SUM is specified, the 
tape error statistics are summarized on either the history tape or SYSREC. 

It is possible to print or summarize tape error statistics by volume serial number 
or by tape drive address. 

When tape error statistics are summarized by volume serial number, it may be 
possible to reduce processing time by allocating more main storage to the EREP 
partition. Approximately 90 distinct volumes can be summarized in a lOK 
partition. When the SYSREC file contains recordings for more than 90 distinct 
volumes and EREP is run in a lOK partition, the SYSREC file is read and 90 volumes 
are summarized; then the SYSREC file is processed again and the remaining (or 
next 90) volumes are summarized. 

If you want to reduce processing time when there are more than 90 volumes, 
therefore, you must allocate enough storage, thus allowing all volumes to be 
summarized on only one read -through of the SYSREC file. Approximately 12 
additional volumes can be processed for each IK added to the partition. To 
calculate the number of volumes that can be summarized in a particular partition, 
use the following formula: 






80 bytes 

P — if tape is 

assigned 

82 



2740 



\.J 
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Processing the TES History Tape with the ESTVUT Utility Program 

When a TES history tape is created from the data on SYSREC, ESTVUT (the 
ESTV Dump File Program) is used to process the data on the TES history tape. 
This utility program dumps the TES history file on SYSLST, 

ESTVUT consist of one module that has to be cataloged in the core image library. 
The module name to be used in the INCLUDE statement for this routine is 
IJBTESUT. 

Control Statements necessary to run ESTVUT. 

ESTVUT can be executed either from SYSRDR or from SYSLOG. An example 

of the job control statements required for ESTVUT is: 

//JOBESTVDUMP 

// ASSGNSYS005,X'181' 

// ASSGN SYSLST,X'OOE' 

//TLBLTAPEIN 

// LBLTYP TAPE 

// EXEC ESTVUT 

/* 

/& 

Symbolic Unit Assignments: Every symbolic unit required for execution of the 
ESTVUT program must be assigned either temporarily for one job, or permanently. 

• SYS005 must be assigned to the magnetic tape unit on which the TES 
history file is mounted. 

• SYSLOG must be assigned to a 32 1 0, a 32 1 5 or a video display 

unit for all executions of ESTVUT in order to log inquiries and accept rephes. 

Label information: Label information must be available to the system whenever 
the devices are used in the execution of ESTVUT 

• The first operand of the TLBL statement for the input tape must be 
TAPEIN 

• A LBLTYP for tape is required if the program uses tape and has been 
cataloged as a self-relocating program (+0 in the PHASE statement). This 
statement reserves space for processing standard label information. 
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Contents and format of printed output 

When the operator specifies a printer as the output device , the collected error 
statistics are formatted and printed as illustrated below: 



VOLUME 




TIME 


CHANNEL 


TEMP 


TEMP 


PERM 


SERIAL 


DATE 


OF DAY 


/UNIT 


READ 


WRITE 


READ 


xxxxxx 


yr/day 


hr.mn.sc. 


cuu > 


nnn 


nnn 


nnn 


PERM 


NOISE 


ERASE 


CLEANER 


SIOS 


TAPE 


BLOCK 


WRITE 


BLOCKS 


GAPS 


ACTIONS 


USAGE 


DENSITY 


LENGTH 


nnn 


nnn 


nnn 


nnn 


nnnn 


nnn 


nnnn 



Each page of output contains 50 lines of data. 

On the last page, a message is printed below the last line of data. The message is: 
ESTV TAPE FILE DUMPED 
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Execute the EREP program at the request of the customer engineer or in response, 
to an instruction in an error message. The operator commands necessary to 
execute EREP through either SYSLOG or SYSRDR are: 

PAUSE BG,eOJ 



//TLBL EREPNEW 


(see note 1) 


// EREPUP 




//TLBL TAPE IN 


(see note 2) 


TESUP 




//ASSGN SYS007,X'cuu' 




//ASSGN SYS008,X'cuu' 


(see note 3) 


//LBLTYPTAPE 




//EXEC EREP 





Note 1: This card is necessary only if you want to create or update either a 

history tape or a history tape and a Model 145 RDE tape. Use EREPNEW when 

creating and EREPUP when updating. The options SELECT, TAPE and RDESUM 

always require the tape label EREPNEW. 

Note 2: This card is necessary only if you are creating or updating the TES 

history tape. Use TAPEIN when creating and TESUP when updating. 

Note 3: This control card is necessary if you are processing a TES option. 

Then EREP issues a message to the operator via SYSLOG or SYSIPT that is to be 
used for entering the EREP options. 

3E1ID ENTER OPTION SOURCE ,C=CARD, 
S=CONSOLE,N=NONE 

The operator must respond with one of the following: 

• C followed by END for SYSIPT 

• S followed by END for SYSLOG 

• N followed by END for the default option, EDIT. 

The default will be N END or just END, and the result will be the editing and 
printing of the SYSREC file. If the operator response is C END or S END, the 
system awaits option data on either SYSIPT or SYSLOG. Enter CANCEL END 
if you wish to cancel the job at this time. 

If any response other than C, S, N, CANCEL, or END is entered: 

3E25I INVALID RESPONSE 
will appear on SYSLOG and message 3E1ID is reissued. 

Entering EREP options 

EREP options can be entered through SYSLOG or through SYSIPT. 

If you use the console printer-keyboard for input, you respond to the prompter 
messages. 

There can only be one option per line (SYLOG entry) or one option per card (card 
entry). Only one option card for each type of option (EDIT, CLEAR, SUM, HIST, 
TES, and SELECT) may be entered in an EREP run. However, when entered via 
SYSLOG, the SUM and SELECT options may be executed more than once in a 
single EREP run. Table F-3 lists the EREP options. 

You can alter the order of EREP actions by specifying two options. For example: 

OPTION EDIT Edit and print the SYSREC file . 

OPTION HIST Update the history tape, and then clear the file. 

*The END key on the Model 125 is replaced by the ENTER key 
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Job stream via 
SYSRDR 




3E11D ENTER OPTION SOURCE, C=CARD, 
S=CONSOLE, N=NONE 



Select option 



Enter C 
Press END 



Enter S 
Press END 



Enter N 
Press END 



System waits for EREP options 
to be entered, for details see F-5 



'^n,y^ 




Options entered 
via SYSIPT 



^-Kiy 



Options entered 
via SYSLOG 




When RMS=NO 
Run EREP only when hardware 
failures are detected on channel 
attached input/output devices, 
magnetic tape units and TP. 
Use MAINTENANCE LOG 
ANALYSIS to display hardware 
failures. F-5. 




Default option EDIT 

selected. 

Refer to table F-3-D 



Yes 



Refer to table F-3-A 



Yes 



3E05A ENTER SUMMARY PARAMETERS 
Refer to table F-3-B 



Yes 



3E03A ENTER SELECT PARAMETERS 
Refer to table F-3-E. 



Option EDIT, CLEAR 
RDESUMorHIST. 
Refer to table F-3-D 
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For input from either SYSIPT or SYSLOG, embedded blanks within the operation, 

option, or parameter are not allowed. Misspelled words, syntax errors, duplicate 

option statements and unsupported options are invalid. '\^ 

When input is from SYSIPT, these errors will cause 40 bytes of the card to be 
issued to SYSLOG along with the message : 

3E041 INVALID PARAMETER 

or 
3E12D INVALID OPTION 

At this time, you may place a corrected card in SYSIPT and then press END to 
process the desired option. If you do not want to process the card in error, press 
END and the program will ignore that option card. However, if you wish to cancel 
the job, enter CANCEL END and the EREP job will be canceled. Multiple options 
are allowed by EREP. See figure F-3-D for a summary of the EREP options. 

Entering options via SYSLOG: When EREP options are entered via SYSLOG, 
it is possible to execute the SUM and SELECT options more than once during an 
EREP run. After the SUM or SELECT function has executed, the message 

3E03A ENTER SELECT PARAMETERS 

or 
3E05A ENTER SUMMARY PARAMETERS 

is issued to SYSLOG. You may execute the SUM or SELECT function again by 
entering parameters at this time. If you wish to terminate the SUM or SELECT 
option, press END. 

When entering the EREP option via SYSLOG, the entry must not exceed 80 
positions. Enter, in this sequence: 

1. The operation, OPTION 

2. A blank X^ 

3. The option. 

Any parameters should follow the OPTION statement on the next line(s). Repeat 
this procedure for each option; when all options have been specified, press END to 
continue processing. 

Note: The END key on the Model 125 is replaced by the ENTER key. 



\. 
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Entering options via SYSIPT: When entering the EREP options via SYSIPT, EREP 

column 1 must be blank and only one option per card is allowed (for example, 
HIST with UPNEW or with NEW and/or 2 is considered one option). Each option 
may only be entered once for each execution of the EREP program. 

Example job streams for executing EREP: 

//J0BEXAIVIPLE1 

//TLBLEREPNEW 

//TLBLTAPEIN 

// ASSGN SYS007,X'cuu' 

// ASSGN SYS008,X'cuu' 

// ASSGN SYS009,X'cuu' 

// LBLTYP TAPE 

// EXEC EREP 

OPTION HIST, NEW 

OPTION TES, NEW 
/* 
/& 

// J0BEXAMPLE2 
// TLBL TESUP 
//TLBLEREPUP 
// ASSGN SYS007,X'cuu' 
// ASSGN SYS008,X'cuu' 
// ASSGN SYS009,X'cuu' 
// LBLTYP TAPE 
// EXEC EREP 

OPTION EDIT 

OPTION TES 

OPTION HIST 

r 
/& 

EREPNEW and EREPUP must be the filenames for new history files or for 
updating. TAPEIN and TESUP must be the file names for a new TES history tape 
or an update TES history tape. 
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An example of an EREP output obtained after a storage failure. 

The programmer's marks indicate the areas of interest. 

Note: the entry CONTROL WORD ADDRESS is not applicable for the Model 125. 



~X 
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When to use EREP E R E P 

Your IBM customer engineer will usually advise you when an EREP printout is 
required, and tell you which option to select. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message OTllW in the DOS IVS Messages manual will request you to 
RUN EREP. 

Other DOS/VS messages that request you to RUN EREP are issued, for example, 
in the following cases: 

• When the first record on the last track of the recorder file is reached, run 
EREP to avoid the risk of losing statistics. 

• When an unrecoverable I/O error on the recorder file occurs while the 
record indicated is being accessed, the record is ignored and processing 
continues. If this error persists, run EREP to retrieve the information from 
the file and recreate the file using different disk extents. 

• When SYSREC becomes full, no further recording occurs until the file is 
purged. To avoid the risk of losing statistics, run EREP. No recycling of the 
file occurs. 

• For system termination situations (for example, a machine check was 
unrecoverable, the channel caused system reset, or two channels are 
damaged) encountered by MCAR/CCH, recording is attempted. Depending 
on the success of recording, the execution of EREP is requested. An attempt 
is made to write a message to the operator. If the attempt is unsuccessful, 
the message code is in low main storage. 

• If the recorder file is more than 90% full at IPL time, the operator is requested 
to run EREP to prevent the loss of pertinent hardware data. 

Another occasion when you may choose to execute the EREP program is when you 
suspect that a hardware error is causing program errors. From the EREP printout 
you are able to detect any hardware failure and inform your IBM customer 
engineer of it. 
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SEREP 

(MODELS 135, 138, / >, 

1 45, 1 48, 1 55- 1 1 ) SEREP is a self-loading, stand-alone program used to : \^.^ 

1 . Write the logout from real storage to some storage device such as tape for later 
use by the IBM GE 

2. Perform a hard-copy Edit/Print of the logout. 

When to use 

SEREP is primarily an aid provided for the IBM CE to help his offline diagnosis 
of hardware failures. For this reason SEREP need only be executed on the advice 
of the IBM CE or when requested to do so by a message on SYSLOG, or when a hard 
wait occurs and byte 1 of low real storage contains S (X'E2'). 

Flowcharts in Section 3 indicate when to use SEREP during IPL errors or if the 
system enters a hard wait state. 

Not applicable to the Models 1 15 and 125. 
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C 



Start 



SEREP 

(MODELS 135, 138, 

145, 148, 155-11) 






Before executing ensure 
that there is no system 
activity. 




Yes 



Press 

SYSTEM RESET 



1 



See next page 



Set CHECK CONTROL to 
STOP AFTER LOG 



Press START and wait 
until CPU stops 




a. 



Punch 3-character address 
(for exannple, 'OOD') of re- 
quired output device in cols. 
67, 68, and 69 of last TXT 
card (next to last card in 
SEREP deck) 



X 



Enter SEREP deck 

into card reader and load 

SEREP using IPL procedure 



Yes 




1 



To retry, press RESTART 

1 



When edit is complete, 
write date and time on first 
page of logout 



Re-IPLif job 
processing is 
to be attempted. 



The procedure for executing the SEREP program. 



Walt state while executing SEREP 

Normal Waits 

When no output device is specified, or the specified device 
is not ready, the system enters the wait state after loading 
SEREP 

Hard Waits 

An unexpected program check during execution of SEREP 
causes a message to be printed, and the system enters the 
wait state. Retry is attempted by pressing RESTART. Re- 
IPL should be avoided because alteration of PSWs by the 
SEREP program may cause that edit to be erroneous. 

Termination 

When logout is complete, a message is issued and the system 
enters the wait state. If no log is found, a message is issued 
and the system enters the wait state. 



F-4 F 



Avoid new IPL procedure. Because SEREP 
might have altered its PSW by this time, a 
re- IPL can cause part of edit to be wrong. 

The only possible operator intervention that 
may be required would be for mounting the 
accumulation tape when the program asks for it. 



Serviceability Aids 2.243 



Hardware Error Recording and Recovery 



SEREP 
(MODEL 158) 



Unlike the Models 135, 138, 145, 148, and 155-11, the Model 158 has no CPU 
logout area in real storage. Instead of being recorded in that area, certain types 
of hardware errors are recorded on the Log Recording Console File, The SEREP 
program also resides on the console file and can be loaded through its own 
IMPL procedure by using the MANUAL, SERVICE and INDEX frames. When 
SEREP is loaded, the SEREP frame is displayed to enable you to select one of 
the options. The options include: 

• Write the log to tape 

• Edit and print the log 

• Select and process one of eight previous logs. 



f 



How to execute (Edit and print option) 

1 . Press STOP followed by MODE SEL 
The manual frame will be displayed 

2. Type in F2 or press light pen to lozenge ■ SERVICE FRAME 

(If a "hard copy" of the service frame is required on the 3213 printer, press 
COPY key or press light pen to lozenge » COPY) 
The service frame will be displayed. 

3. Type in F4 or press light pen to lozenge ■ 4-INDEX FRAME 
The index frame will be displayed as shown below. 

(Using COPY will not generate a hard copy of this frame.) 




''kJ 
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How to execute . . . continued 

4. Type in F28 or press light pen to lozenge 
■ 28-EXTERNAL DIAGNOSTICS 

The frame shown below will be displayed. 

(Using COPY will not generate a hard copy of this frame.) 
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(MODEL 158) 





o 



5. Press light pen to the lower lozenge until number 08 is displayed at the 
position of the two XX in the example shown above. 

6. Press Ught pen to upper lozenge on the display 
The program frame will be displayed. 

7. Press REQ key 

8. Respond to messages displayed as shown in the example below. 




%J 
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LOG ANALYSIS 
(MODELS 115 AND 125) 



The LOG ANALYSIS facility allows the operator to display statistical data about 
hardware failures that are logged on the system diskette. 

The type and amount of detail displayed is selected by entering appropriate 
mnemonics into the MAINTENANCE PROGRAM SELECTION display. The 
sequence of displays is designed to guide the operator from the initial type of 
display selected to displays that provide more detailed data. 

For an interpretation of the data displayed refer to the Central Test Manual. 

The example shown on the opposite page illustrates the sequence of displays 
obtained to display the errors logged by the IPU (Instruction Processor Unit). 



( 



When to use 

Your IBM customer engineer will usually advise you when to use this feature, and 
tell you which display to select. He may require a hard copy for offline analysis 
of all the displays selected, therefore save the hard copy output. 

Under certain hardware failure conditions, a message issued on SYSLOG, for 
example, message OTl IW in the DOS/ VS Messages manual will request you 
to RUN EREP. 

For the Models 115 and 125 you should only run EREP when requested to by a 
DOS/VS message. For example when the recorder file is full a message will be 
displayed informing you of this and re questing you to run EREP. Otherwise, before 
running EREP you should first contact your IBM customer engineer, who will then 
advise you on further action as mentioned in the previous paragraph. 



How to use 



''%,:^J' 



To obtain the LOG ANALYSIS display required using fast selection, 

1 . Press the MODE SELECT key. 

2. Type in M followed by the associated mnenomics of the analysis to be displayed. 

3. Press the ENTER key. 

By selecting and entering the appropriate mnenomics, the operator can display 
logged errors for a particular input/output device or a particular part of the CPU. 
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Press MODE SELECT 



^ifc.* 



LOG ANALYSIS 
(MODELS 115 AND 125) 



'MODE SELECTION 



R SYSTEM RESET 
C ADDRESS COMPARE 
L PROGRAM LOAD 
T INTERVAL TIMER 
K CHECK-CONTROL 
D STORAGE DUMP 
: ICA LINE MODES 
MODE SPECIFICATION: 



A ALTER/DISPLAY 

I INSTRUCTION STEP 

P RESTART 

M MAINTENANCE 

S STORE STATUS 

U SAVE USAGE COUNTERS 



Enter M and press ENTER 



■ MAINTENANCE PROGRAM SELECTION 



CE--MAN.CPS 



A= LOG GENERAL J = CPU S = I 

B = CPU K - 1403 U = ( 

C = CARD/PRINT I/O L = 2560/5425 V = I 

D = DISK M = 3504/3525 X = I 

E = ICA N = DISK Y - P 

I = CHANG. DISKETTE O = ICA Z=r 
PROGRAM SELECTION: M R = SYSTEM TEST (ASCP) 



X = IPU 

Y -MATRIX S 

Z = MATRIX M 



Enter B and press ENTER, 




CPU LOG ANALYSIS PROGRAMS * 



B = SVP BUS~0 LOG 

C = SPU ANALYSIS 

D = IPU LOG DISPLAY 

E = MSC ANALYSIS 

F = MSC LOG DISPLAY 

G = lOP 8-F ANALYSIS 

H = lOP 8"F LOG DISPLAY 

PROGRAM SELECTION: MB 

(:C003 M:X.DA00.4C, 



K = MTA LOG DISPLAY 

L = MSCI LOG ANALYSIS 

M = MSCI LOG DISPLAY 

N = MPX ANALYSIS 

O = MPX LOG DISPLAY 



or, enter C and press ENTER 



* CARD/PRINT I/O LOG DISPLAY PROGRAMS * 



3504 LOG DISPLAY H= 5425 LOG DISPLAY 



D= 3525 LOG DISPLAY K= 1403 LOG DISPLAY 



F= 2560 LOG DISPLAY M= 5203 LOG DISPLAY 



PROGRAM SELECTION: MC 



Displaying the IPU Log Analysis 



Serviceability Aids 2.247 



Hardware Error Recording and Recovery 



DISPLAY FRAMES 
(MODEL 158 ONLY) 



This facility enables an operator to display information about hardware failures and 
warn the shift manager of IBM CE immediately about the nature and possible cause 
of the failure. 

Recognizing a hardware failure 

A hardware failure is indicated by a message which 'flashes' on and off at the lower 
right hand corner of the program frame or on the manual frame. 
The example below shows a hardware failure indicated by the words STOR CHECK 
on the manual frame. 



J 







After recognizing the failure an operator is able to 'scan' the display frames and thus 
obtain detailed information about the condition of the hardware. This information 
may enable the IBM CE to diagnose the failure immediately and advise on continued 
system operation. He may also advise that the SEREP is executed and request 'hard 
copies' of the display frame on which the failure is indicated to enable an offline 
diagnosis of the failure. 



How to use 

From the program frame: 

1 . Press MODE SEL 

The manual frame is displayed 

2. Type in F2, or press light pen to lozenge ■ SERVICE FRAME 
The service frame will be displayed 

3. Type in F4, or press Ught pen to lozenge ■ INDEX FRAME 

TJie index frame will be displayed, an example of which is shown in the 
section "SEREP (Model 158)". 

4. Press light pen to lozenge - CPU DISPLAY 

The first display frame will be displayed, an example of which is shown at the 
top of the opposite page. 
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DISPLAY FRAMES 
(MODEL 158 ONLY) 




5. Scan the frame for any characters that flash on and off beside an entry displayed. 
For example, Z-BUS 614250 indicates that the hardware failure is caused by a 
failure in the Z-BUS. 

If a hardware failure is indicated, press COPY to obtain a hard copy of that 
frame and make a note on the hard copy about the error. (Characters that 
indicate an error are not copied by the system.) 

6. Press the key marked||on the keyboard, as illustrated below. 
The next display frame will be displayed. 



CNCl 


1 


< 
2 


2 


4 


5 6 


> 

7 


* 
8 


( 
9 


) 



- 


+ 
& 


^ 




-H 


Q 


W 


E F 


T 


Y 


U 


1 





P 








REQ 


LOCK 


A 


S 


D 


F G 


H 


J 


K 


L 


i 
$ 


'^ 




-«-l 


COPY 


SHIFT 


Z 


X C 


V 


B 


N 


M 


I - 


— 1 


7 

/ 


SHIFT 




KEYBD 
RESET 








ENTER 



M 


STOP 


MOD 
SEL 


IRPT 


t 


\ 




-* 




7, Repeat steps 5 and 6 until all display frames have been scanned and hard copies 
made of those containing information about the failure. 

8. Press CNCL to obtain the program frame. 



When to use 

1 . After recognizing a hardware failure as shown in the example above. 

2. On advice from your IBM CE. 
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Note: Not applicable to the 
Models 115 and 125 using a 
supervisor that does not 
support the RMSR function. 



IBM provides a set of device test programs that run under control of DOS/VS. 
These test programs and the onUne test executive program form the onHne test 
system. The Online Test Executive program (OLTEP) is an interface between the 
system and the onhne test programs (OLTs) and communicates with the operator 
during the running of tests. 

Some uses: 

• Diagnosing I/O errors 

• Verifying I/O device repair and engineering changes 

• Checking I/O devices 

Some features: 

• Multiple device testing 

• Datat security 

• Data protection 

• No re-IPL time required 

• Prompting 

• ASCII data conversion 

I: ♦ Accessing of error recording information 

• CDS Equate function 

OLT 






/ 



QLTEP 




OPERATOR 



Supervisor 



Card 
Read/Punch 




Disk 




OLTEP-System Relationship 
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Description and Operation LTEP 

OLTEP operates much like other problem programs in DOS/VS. It is cataloged into 
the core image library and called by standard job control statements. When OLTEP 
is called, it notifies the operator that it is active and it communicates with him 
during testing. OLTEP can run in a batch-only system or as a background program 
in a multiprogramming environment. OLTEP must be run in the background 
partition in real mode and requires at least 16K. 

You can test an I/O unit with minimum interference to other programs running 
on the system. Testing an I/O device ordinarily does not interfere with system 
input and output. Any unit being tested (except for direct access devices) must not 
be assigned to the foreground partitions. Direct access devices, however, may be 
shared. 

An OLTEP user language defines and controls the test. With this language, you 
select the devices to test, the test sections to run, and the options to exercise. You 
enter this information via the console device or in the form of a control statement 
in the job input stream. This information is referred to as the test-run definition, 
which is common to OLTEP components for all operating systems. 

You can test multiple devices of the same type with no operator interventions 
other than those required for data protection and data security. OLTEP loads and 
executes the test sections one at a time until all the tests for one device are 
completed. If requested, the test sections then repeat for the next available device. 
Testing continues in this manner until all units in the test-run definition are tested. 

During testing under control of OLTEP, the system error recovery procedures are 
bypassed for the device being tested. OLTEP has built-in data integrity safeguards 
so that no data is destroyed without operator permission, and no protected data 
is accessed during testing. 
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TOLTEP 



IBM provides a set of device test programs that run under DOS/VS control. These 
test programs and TOLTEP make up the On-Line Test System (OLTS). TOLTEP 
is automatically included in the system with VTAM and is the interface between 
the system, the TOLTEP initiator, and the test programs. 
The illustration below shows the interrelationships between the components. 



\_/ 



Other Terminals 




DOS/VS 

Control 

Program 



MX 




.,y 



OLTEP/System/TOLTEP Relationship 



>' 



2.252 Serviceability Aids 



Hardware Error Recording and Recovery 

Description and Operation TOLTEP 

TOLTEP operates like other problem programs an can execute concurrently with 

OLTEP under DOS/VS. 

It is cataloged into the core image library and the activated" at the same time as VTAM. 

Communication is initiated when the first person requests diagnostic services. Multiple 

users may request and use these facilities simultaneously. When TOLTEP is invoked, 

the requestor is sent a message saying that TOLTEP is active and requesting further 

input. 

TOLTEP commands are used to define and control the test, and these commands are 
compatible with OLTEP commands. You select the devices to be tested, the test 
sections to be run, and the options to be exercised. You can enter this information 
from the system console or from any network device capable of alphameric character 
input and output. This information is called the test-run definition, which is common 
to TOLTEP components for all operating systems and is similar to the information 
required for OLTEP. 

You can test multiple devices of the same type with no system operator intervention 
other than requesting permission to test specific devices. TOLTEP loads and executes 
the test sections one at a time until all the tests for one device are completed, then 
repeats for the next device specified and available. Testing continues in this manner 
until all the units specified in the test -run defmition are tested. 

During testing with TOLTEP, the system error recovery procedures are bypassed 
for the device being tested. TOLTEP has built-in data integrity safeguards so 
that no data is destroyed without operator permission, and no protected data 
is referred to during testing. 

For additional information on the use of TOLTEP, see TOLTEP fo, VTAM, GC28-0663. 
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DOS/VS Serviceability Aids and Debugging Procedures 

SECTION 3 






DEBUGGING FOR 
OPERATORS 



Debugging for Operators 3 . 1 



Section 3 

DEBUGGING 
PROCEDURES 
FOR OPERATORS 



How to Use 

This section is in the form of flowcharts that help the operator in the initial 
isolation of and possible recovery from errors that occur during system operation. 

• Eachflowchart deals with a specific type of malfunction. 

• Pointers to operator's flowcharts in Section 2 (that must be followed to 
complete a procedure in this section) are referenced by the page tabs 
used in Section 2. 

For example: 



Execute a stand 
alone dump 
A-3-F 



Key to references: 



X-X~F 



Page tab 
of Section 2 

Flowchart 



\^ 



• When immediate recovery is not possible, offline program debugging is 
indicated. 



Wait state codes 
Error during IPL 
Initial system checks 
System in WAIT STATE 
Unintended LOOP 
Obviously incorrect output 
Job canceled by system 



Table 3.1 3.3 

Chart 01, parts 1 through 9.... 3.5 

Chart 02 3.15 

Chart 03, parts 1 through 4 3.16 

Chart 04, parts 1 through 6 3.22 

Chart 05 3.28 

Chart 06 3.29 



3 .2 Debugging for Operators 



Section 3 

WAIT STATE CODES 



\fct*r 



^^tuiT 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 


EXPLANATION 


IPL Error Messages placed in Low Address Storage 


X'FO' 


X'C9' 


X'FO' 


X'FO' 


This code indicates that less than 16K of real storage is left for problem programs. Check 
that the correct disk volume is mounted on the device assigned to SYSRES, and re-IPL. 
If the error recurs, the system programmer must check the allocations of real partitions 
specified in the supervisor to be used, and check that at least 16K of real storage is 
available for execution of problem programs running in virtual mode. 


X'FO' 


X'C9' 


X'FO' 


X'FV 


If a card reader has been assigned to SYSRDR during system generation and is to be the IPL 
communication device, press the INTERRUPT key. 

If a card reader has not been assigned to SYSRDR during system generation and yet it is 
to be the IPL communication device, simply READY the reader. 


X'FO' 


X'C9' 


X'FO' 


X'F2' 


This code means that the supervisor requested cannot be found. 

Check that the correct disk volume is mounted on the device assigned to SYSRES. If it is 
correct, re-IPL and specify a different supervisor when message 0I03A is issued and press the 
END/ENTER key, or press END/ENTER key only, to load the standard supervisor. (If 
possible contact the system programmer and check which supervisor to use.) 


X'FO' 


X'C9' 


X'FI' 
X'F2' 


X'FO' 
X'F8' 


Refer to messages 0I10A - 0I28A in DOS/VS Messages. 


IMCH/CCH/IPL Hard Wait Codes placed in low address storage 


x'cr 

X'C2' 
X'C3' 
X'C4' 
X'C5' 
X'C6' 

X'C7' 
X'C8' 
X'C9' 
X'DI' 
X'07' 


X'E2'(2) 
X^E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 

X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E2'(2) 
X'E6' 


A, 1, S(1) 
Not used 
A, l,S(1) 
A,I,S(1) 
A. I,S(1) 
A. I,S(1) 

a;i,S(1) 
A, l,S(1) 
A, 1, S(1) 
A, l,S(1) 
Channel 


Not used 
Not used 
Not used 
Not used 
Not used 
Not used 

Not used 
Not used 
Not used 
Not used 
Unit or 
X'OO' 


Irrecoverable machine check. 

Irrecoverable channel failure during RMS fetch. 

Channel failure on SYSLOG when RMS message scheduled. 

No ECSW stored. 

Channel failure: ERPBs exhausted. 

Channel failure; two channels damaged or a damaged channel situation occurred while RMS 

was executing an I/O operation. 

Channel failure; systenn reset was presented by a channel. 

Channel failure; system codes in ECSW are invalid. 

Channel failure; channel address invalid. 

Irrecoverable channel failure on SYSVIS. 

IPL I/O erroror equipment malfunction; condition code 2 during STIDC instruction. 

Channel and unit indicate whether device in error is SYSRES or communication device. 

When byte 3 = X'OO', byte 2 indicates the channel for which STIDC instruction was 

issued. Re-IPL system. 



Notes: J. a (X'CV) = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') = SYSREC recording successful. 

2. S (X'E2') = Run SEREP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of the wait PSW. 

Table 3-1 . WAIT STATE coded messages, part 1 of 2. 
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3.3 



Section 3 

WAIT STATE CODES 



BYTEO 


BYTE 1 


BYTE 2 


BYTE 3 




SDAID Hard Wait Code 


X'61' 


X'E6'(3) 


Channel 


Unit 


Another device is running in burst mode on same channel as SDAID output device. 
Re-I PL system. 


SDAID Soft Wait Code 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready, Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'OO' (3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to 
continue operations. 


The folk 


)wing Har 


d Wait Cod 


es are placed in general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CI L. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


•Channel Failure if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS=NO is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO'. 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDIR canceled during system GIL update. If this occurs, the system CIL is only 
partially updated and must be restored before use. This hard wait condition can also occur 
if the FETCH QUEUE BIT (FCHQ) is set in the linkage control byte in the partition 
communication region owned by the terminating partition. 


X'OO' 


X'OO' 


X'OF' 


X'F5' 


TFIX count outside limits. 


X'OO' 


X'OO' 


X'OF' 


X'F4' 


$$A transient not found (the transient name can be found in ERBLOC). 


X'OO' 


X'OO' 


X'OC 


X'CC 


No recovery possible from CRT errors. 


Device E 


rror Reco 


very Wait C 


odes place 


d in low address storage. 


X'OSto 


X'CI'or 


Channel 


Unit 


Error recovery messages. Refer to chart E-3-F 


X'60to 


X'C4' 




t 


- 






Notes: /. a (X'CI'i = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2') - SYSREC recording successful. 

2. S (X'E2') - Run SE/^EP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of tfie wait PSW. 



Table 3-1. WAIT STATE coded messages, part 2 of 2. 
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Operator's Flowcharts 



CjEZ3 



Error during IPL 

CHART 01, PART 1 



Ensure that you have set the correct 
address for the device to be used as 
SYSRES. and check that the correct 
SYSRES pack is mounted. 



Ensure the word TEST is not diplayed 
or the TEST indicator is not 'ON'. 
If it is, establish the reason through 
your shift manager or IBM CE. 



, ,/i '';- System CHECK indicators 

■ /'l'i:!'/'v,{' 3''6 explamed m the 



/' die CApiaiiicu III iiic 

OPERATING PROCEDURES 
manual for your Model of System/370 



This must be 
done to tell 
DOS/VS which 
console to use 



C^' 




Specify the supervisor 
required or press 
REQUEST/ENTER 
for default supervisor 



Which of the following did you do next? 



Ready a 
card reader 



Press 
EXT INT 



Press I 

REQUEST/ENTER or 
on console I 



Ready a 
diskette reader 



IPL communication 
device is the card reader 
made ready 



IPL communication device 
is the card reader assigned 
during system generation 




IPL communication 
device is SYS LOG 




IPL device is 
diskette reader 
made ready 




To part 5 



To part 2 



To part 2 
Debugging for Operators 



3.5 



Error during IPL 

CHART 01, PART 2 



I 



From part 1 




No 



For example: 

01151 PUB ALREADY EXISTS 



To part 3 



Yes 



Complete operator action > 
under appropriate message • 
number in DOS/VS Messages j 



See D-1-F For Models 135, 138, 
145, 148, 155-11 
and D-2-F for Models 115, 125 
and D-3-F for Model 158 



Dump, or display and note the 

• Current PSW 

• 16 Control registers 

• 1 6 general registers 

• Low address storage 






Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 







/Complete operator/programmer 
faction. See Table 3-1. 



To part 8 
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Page of GC33-5380-3, Revised July 28, 1978, By TNL GN33-9254 

Error during IPL 
CHART 01, PART 3 



From part 2 



\ 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



See D-1-F for Models 135, 138, 145, 
148, 155-11 

and D-2-F for Models 115, 1 25 
and D-3-F for Model 1 58 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 



o 



01201 IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL = nn 




Yes 






ner \ 



C Complete operator/programmer 
action. See Table 3-1 J 



Yes 



Proceed with normal job 
processing 



Put SYSRES on a different drive, 

and if possible, select a different 

channel; but caution: 

If there has been a head crash, 

this damage could be propagated 

to the other drive. 

(Do not forget to set the new 

address for SYSRES.) 



Re-IPL 




To part 4 
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Error during IPL 

CHART 01, PART 4 



From part 3 



( 



01201 IPL COMPLETE FOR 
DOS/VSRELxx.x 
ECLEVEL = nn 




Yes 



No 



Use the reserve (backup) 
SYSRES pack 



Re-IPL 



01201 IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL= nn 




Yes 



Is it the first IPL for 
a newly assembled 
supervisor? 



I 



Save notes about your 

problem and actions, 

and inform your shift manager. 



No 




Proceed with normal 
job processing 



Yes 



See D-1 -F for Models 1 35, 1 38, 1 45, 
148, 155-11 

and D-2-F for Models 11 5, 1 25 
and D-3-Ffor Model 158 



No 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



Save the notes about your 
problem and actions, and 
inform your system programmer. 



Execute a stand- 
alone dump. 
A-3-F. 



For programmer action 
see section 4 (Chart 01 ) 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 



Inform IBM of 
your problem 
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I 



See D-1-F for Models 135, 138, 145, 
148, 155-11 

and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 1 58 



The first character of a message 
originated by I PL is a 
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Error during IPL 

CHART 01, PART 5 



From part 1 




No 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 




To part 6 




Yes 



Put SYSRES on a different drive, and if 

possible, select a different channel^ 

but caution; 

If there has been a head crash, 

this damage could be propagated 

to the other drive. 

(Do not forget to set the new 

address for SYSRES. 



Complete operator action under 
appropriate message number in 
DOS/VS Messages 



01201 IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL = nn 




Yes 



See D-1 -F for Models 1 35, 1 38, 1 45, 
148, 155-11 

and D-2-F for Models 1 1 5, 1 25 
and D-3-F for Model 158 



Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 



Proceed with normal job 
processing 



H 
To part 8 
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Error during IPL 
CHART 01, PART 6 



See D-1-F for Models 135, 138, 145, 

148.155-11 

and D-2-F for Models 1 1 5, 1 25 

and D-3-F for Model 1 58 

Coded messages stored in bytes t 
0-3 of low address storage are l ^ \ 
listed in Table 3-1 ^ 



01201 IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL = nn 



From part 5 






Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 16 general registers 

• Low address storage 




Yes 



I 



Complete operator action 
under appropriate message 
number in DOS/VS Messages 



Yes 



Put SYSRES on a different drive, 

and if possible, select a different 

channel; but cautiont 

If there has been a head crash, 

this damage could be propagated 

to the other drive. 

(Do not forget to set the new 

address for SYSRES.) 



(Pro 



Proceed with normal processing j 






Re-IPL 



01201 IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL= nn 




Yes 



Use the reserve (backup) 
SYSRES pack 



Save notes about your problem 
and actions, and inform your 
shift manager 



Re-IPL 




( Proceed with normal] processing 



To part 7 
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From part 6 



CHART 01, PART 7 



y 



01201 IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL=nn 




Yes 



No 



Use new IPL control cards 



Re-IPL 



01201 IPL COMPLETE FOR 
DOS/VS REL xx.x 
ECLEVEL = nn 




Yes 



Is it the first IPL for 
a newly assembled 
supervisor? 



No 



Save notes about your 
problem and actions and 
inform your shift manager 




Proceed with normal 
job processing. 



Yes 



No 



Execute a stand-alone 
dump. 

A-3-F. 



Execute a stand-alone 
dump. 

A-3-F. 



Save the hard copy of 
SYSLOG output and the 
stand-alone dump for IBM 




Save the notes about your 
problem and actions, and 
inform your system programmer. 



Inform IBM of 
your problem 



For programmer action 
see Section 4 (Chart 01) 



Debugging for Operators 3.11 



Error during IPL 
CHART 01, PART 8 



From part 2 







Re-IPL 




Yes 



{ 



Proceed with normal 
job processing 



From part 5 




Dump, or display and note the 

• Current PSW 

• 16 control registers 

• 1 6 general registers 

• Low address storage 



See D-1-F for Models 135, 138, 145, 

148,155-11 

and D-2-F for Models 1 1 5, 1 25 

and D-3-F for Model 1 58 



Coded messages stored in bytes 
0-3 of low address storage are 
listed in Table 3-1 



Yes 



If possible, use a different 
device as IPL communication 
device; but cautiont 
If there has been a head 
crash, this damage could 
be propagated to the 
other drive. 



/■ 'N 
V-.-^"' 



Execute a stand- 
alone dump. 
A-3-F 




Use reserve SYSRES pack, 
and if communication - 
device is'SYSRDR, use a 
new IPL control card deck. 



Re-IPL 



Yes 



Re-IPL 



To part 9 





To part 9 
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Error during IPL 
CHART 01, PART 9 



From part 8 



From part 8 





0I20I IPL COMPLETE FOR 
DOS/VS RELxx.x 
ECLEVEL=nn 



Yes 



No 




Proceed with normal 
job processing 



Execute a stand 
alone dump. 
A-3-F 



#%^ 
\^'' 



Inform your shift 
manager of your 
problem 



No 




is it the first IPL for 
a newly assembled 
supervisor? 



Yes 



Execute SE REP 
(Refer to F-4-F for 
Models135, 138, 145, 
148, and 155-11) or 
Display log analysis 
(Refer to F-5-for the 
Models 115 and 125 or 
F-6 for the Model 158) 



Save the low address 
storage dump, the stand- 
alone dump, and the 
SEREP printout for IBM. 



Save the notes about 
your problem and 
actions, and inform your 
system programmer. 



Rebuild SYSRES. 

Save the original SYSRES. 

Save the low address 

storage dump. 

Save the stand-alone dump. 

Inform IBM of your 

problem. 



Inform IBM of 
your problem 



For programmer action 
see Section 4 (chart 01 ) 



Proceed with normal 
job processing 
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Initial System Checks 

NOTES FOR CHART 02 



r 



< 



r 



Note 2 < 



\ 



r 



Note 3 < 



V 



Note 4 < 



Recognizing a wait state 

Any of the following observations confirm that the system is in a Wait State: 

• WA I T indicator remains on, or on the Models 1 15 and 125 tiie word WA I T 

remains displayed on the video display unit. 

SYS indicator remains off (Not applicable to the Models 1 15 and 125). 

No I/O device activity occurs. 

One or more SYSTEM CHECK indicators on. 

A HARD MACHINE CHECK message is issued on SYS LOG or a 

coded "wait state" message may be contained in bytes 0-3 of 

low address storage or in GR 1 1 (X'B') 



Recognizing a loop 

One or more of the following symtoms may indicate that a job/program is in 
an unintended loop: 

• A steady glow in the light of the system control panel with the SYS indicator 
on. For the Models 1 15 and 125, the word WAIT may flicker on the video 
display unit. (This depends on the size and nature of the loop.) 

• A rhythmic pattern in the lights of the system control panel, or, for the 
Models 1 15 and 125, the word WAIT may flicker on the video display unit. 

• A pointless recurrence of I/O activity. 

• A job /program that does not change status for a long time. This may result, 
for example, in an absence of I/O activity with both SYS and WAIT 
indicators on. 

A note to the operator: When a loop is recognized, first try to contact the 
programmer before beginning any debugging procedures. If Ihis is not possible, 
follow the instructions in chart 04. 

Recognizing incorrect output 

Incorrect output during system operation may be recognized by any one of 
the following: 

A. Duplicate output 

Output of identical data or more output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 

B. Invalid or unidentified output 

Printed (or displayed) output that is obviously incorrect on: 

• line printer 

• console printer 

• video display unit. 
C Lack of output 

No output when there should be, or less output than expected on: 

• line printer 

• console printer 

• card punch 

• video display unit. 









(^ Job/program canceled by system 

The system's canceling of Job is normally caused by a Program Check Interrupt 



that is recognized by a message, for example: 

BG 0S001 JOB NO NAME CANCELED DUE TO PROGRAM CHECK 



The program is automatically canceled by the supervisor and depending on the 
use of the job control statement, //OPTION DUMP, a dump of the partition 
and supervisor is executed. 



3.1 A Debugging for Operators 



- Check 1 

Message on 
SYS LOG 



- Check 2 

Output from 
job/program 
(See note 3) 



Initial System Checks 

CHART 02 



Did you understand the message and respond to 

it correctly? If no message was printed, go to check 2. 



Yes 



Save SYS LOG 
output, and go to 
check 2. 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Is there unscheduled output? 

Is scheduled output not as expected? 



Yes 



No 



Save the output, 
and go to check 3 



Make a note, and 
go to cheek 3. 



jf\ 



- Check 3 — i 

Input/output 
devices. 



Check 4 

Input/output 
media 



- Checks — , 

Program change 
during run 



- Check 6 

Programmer's 
instructions 



Are the assigned devices set up correctly? (e.g. bits per inch) 



No 



Rerun or restart 
job/program. 



N 



Have any of the assigned devices a malfunction 
condition? (Some examples of device malfunctions 
are listed in Section 1.) 



Yes 



Try to use a different 
device or consult the 
operating guide for the 
device, and inform your 
IBM customer engineer. 



No 



Go to check 4. 



Are you using correct SYSRES pack? 

input files/volumes? 
work files/volumes? 
Input/output devices? 
teleprocessing lines? 



No 



Yes 



Contact your shin manager 
before rerunning or restarting 
the job/program 



Go to check 5. 



Have you altered the contents of any real or 
virtual address area since the job/program began 
running? 



Yes 



Do you understand the programmer's 

instructions? 

(If in doubt, try to contact the programmer.) 




Compare your notes 
of the alterations 
with the programmer's 
instructions. If there 
is a difference, try to 
contact the programmer 
before rerunning the job. 



Go to check 6. 



Contact yoiir shift itianaiger 
before rerunning or restarting 
the job/program 



Go to check 7. 



- Check 7 

Operating 
procedures 



Are there any recent changes in the system 
operating procedures, and if so, do they affect 
this job? 

(If in doubt, contact your shift manager or 
senior operator.) 



Yes 



No 



Contact your shift manager 
before rerunning or restarting 
the job/program 



Go to check 8. 



- Checks 

Categorize the 
malfunction 




System in a WAIT STATE? (See note 1 ) 
LOOP? (See note 2) 

Obviously incorrect output? (See note 3) 
Job/program canceled by system? (See note 4) 



Turn to dnart^, ...... 

Turn to chart 04 


:^^- 


Turn to chart 05 
Turn to chart C^ 


--- 
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Wait State 

CHART 03, PART 1 






Model-dependent 
control console 
layout 


sea 


SB B606SBEI 



Start 



|ooobo| 



WAIT indicator ON 
SYS indicator OFF 



Yps 



f 




The TEST indicator is on when any of the following 
switches are not in the process or normal position. 
1.RATE 

2. CHECK CONTROL 

3. DIAGNOSTIC/CONSOLE FILE CONTROL 

4. ADDRESS COMPARE CONTROL 



No 



Yes 



f 



The MANUAL indicator is on when the CPU clock is 
stopped or the system is in a soft-stop state. Ail pending 
interrupts are handled. Manual store/display operations 
are possible only when the MANUAL indicator is on. 



Yes 






If SYSLOG is inoperative, a device error recovery message 
may have been printed on the line printer assigned as 
SYSLST. 

Example of a device error recovery message 




0P08A iNTERV REQ SYSRDR=OOC 


















inform your shift leader or 
manager of the condition, 
and request time for 
hands-on debugging to 
gather system information. 



Consult DOS/VS 
Messages manual 




To part 2 of this chart 
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From part 1 of this chart 



Wait State 
CHART 03, PART 2 




Yes 



Yes 



See D-1-F for Models 135, 138, 145, 

148,155-11 

and D-5-F for Models 1 1 5, 1 25 

and D-6-F for Model 158 






0^ 



Check that the lastJCL 
assigning SYSLOG was a 
statement and not a 
command 



No 



Dump or display low 
address storage. Use 
ALTER/DISPLAY 



Compare the contents of 
bytes 0-3 of low address 
storage with the list of 
wait state coded messages 
shown in table 3.1 



Yes 



Contiue debugging using 
the flowchart shown in 
Section 2,E-3-F. 





Yes 



Perform indicated 
action 



Yes 



No 



SOFT WAIT 





To part 6 of this chart 



To part 3 of this chart 
Debugging for Operators 
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Wait State 

CHART 03, PART 3 



From part 2 of this chart 







Issue the MAP command. 
Refer to Section 2, E-1 . 



Make each I/O device 
NOT READY, then 
READY in turn, checking 
for any I/O activity as 
this action is carried out. 



No 




Yes 




Does not apply to 
POWER/VS RJE tasks 



No 



Yes 



Contact terminal (s) and 
request data to be 
entered 



Yes 




If an interrrupt occurs, the CPU 
is tak*ft out of the wait state, and 
processing is started under control 
of the program being executed. 



No 



^""""^ 
[^j^ 




To part 4 of this chart 
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o 



From part 3 of this chart 



Wait State 
CHART 03, PART 4 



^■ppw^^ 




To part 6 
of this chart 



To part 5 
of this chart 



To part 5 
of this chart 
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Wait State 



CHART 03, PART 5 



From Part 4 
of this chart 



From Part 4 
of this chart 



Issue the command 
PDISPLAY RJE to 
obtain a status report 
of RJE queue entries 




if Ik 



Either wait for problem 
to be solved at terminal 
or issue the command 
PSTOP line address 
to cancel that RJE line. 



No 



1R17I LINE HAS BEEN 
STOPPED 




Issue the following commands: 
PDISPLAY RDR.ALL 
PDISPLAY LST, ALL 
PDISPLAY PUN, ALL 
Then after the output, if any, 
use the PSTOP command to 
stop the tasks or partition (s) 
running under POWER/VS 




Issue the command 
PEND KILL,OOE 



System dump 
is described in 
section 2, A-2 



No 



H 




No 



KJ 



Yes 



Yes 



3 20 



To part 6 of this chart 
Debugging for Operators 



Continue normal 
system operation 




o 



To part 6 of this chart 



Wait State 
CHART 03, PART 6 



o 



From part 2 of this chart 



From part 2 and 4 
of this chart 



From part 5 
of this chart 




Execute a stand 
alone dump 
A-3-F 





Execute a stand-alone dump 
as recommended in Section 2,, 
A-3-F. On completion of the 
dump, re-IPL and obtain a 
dump or copy of the page data 
set as described in Section 2, C-6 



Execute SEREP (Refer to 

F-4-F for models 1 35, 1 38, 

145, 148, and 155-11) or 

Display log analysis (Refer 

to F-5 for the Models 1 1 5 

and 1 25 or F-6 for the Model 1 58) 



Re-IPL 



If the problem recurs, re-IPL 
and execute EREP (select 
default options) F - 3 - F 



Have the SEREP, EREP 
and stand-alone dump outputs 
available for your IBM 
customer engmeer 



HARDWARE ERROR 

Note: Certain unusual hardware and software failures can 
cause the system to halt processing with both the system 
light and the wait light on continuously. This indicates that 
the current PSW has its wait bit set on but the CPU is 
processing microprogram instructions. If possible, the 
system should be left in this state until a customer engeneer 
has arrived. A stand-alone dump can show the I/O 
operation in process. 






Re-IPL and obtain 
a dump or copy of 
the PDS, C-6 



Save the following system 
information for the system 
programmer. 

• SYSLOG output including 
MAPandPINQUIRE 
command output 

• Line printer output, including 
the stand-alone dump output, 
the dump or copy of the 
page data set, and the 
POWER/VS system dump 
(if applicable) 

• If the stand-alone dump 
was executed, a note of: 

Current PSW 

16 control registers 

16 general registers 

Low address storage 

X'OO'-'BF' 

Job stream (if possible) 

Note of system activity 

Note of your actions 

Input files/volumes 

(if possible) 



OPERATIONAL 
OR 
PROGRAMMING ERROR 



Debugging for Operators 3 .2 1 



Unintended Loop 

CHART 04, PART 1 



Start 



/ ~\, 



Inform your shift leader or 
manager of the malfunction 
and request time for hands-on 
debugging to gather system 
information. If possible, 
check estimated job run 
times with the programmer(s) 



From part 5 of this chart 



Determine if 
loop is in 
supervisor 



Press REQUEST 



Yes 




IMo 



Loop is probably 
in the supervisor 



IMo 



A program or partition is time dependent wlien it uses 
ycme or any of t/ie following I/O methods: MICR 
(Magnetic Ink Character Recognition), OCR 
(Optional Character Recognition), TP 
(Teleprocessing) 




No 



No 



No 



TP suspected of causing loop 



MICR and/or OCR 
suspected of causing loop 



B 

To part 2 of this chart. To part 3 of this chart, 

3.22 Debugging for Operators 



k. 



To part 4 of this chart. 




To part 4 of this chart. 



From part 1 of this chart 



Unintended Loop 

CHART 04, PART 2 



Actions to prevent the 
following procedures 
affecting MICR/OCR 




No 



Empty the hopper of the 
MICR and OCR devices 



If possible consult your 
shift leader or manager 
before making this 
decision. 



I f the message 
INTERV REQ is issued on 
SYSLOG for the MICR 
and/or OCR devices, DO 
NOT READY these devices 




No 



Execute the MAP 
command;refer to section 
2, E-1 




To part 5 of this chart 



No 



For system programmers and IBM CE/SEs only, 

If possible assign SYSLIST to a line printer on the 
partition being used to initiate SOAIDS; If a line 
printer is not available assign SYSLIST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.) 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR 9 and reducing 
the event limits CR 10 and 11. 




No 



To part 6 of this chart. 



To part 6 of this chart. 
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Unintended Loop 



CHART 04, PART 3 

From part 1 of this chart 




Inform terminal (s) of 
malfunction condition 






Is there 
'any input/output 
activity at the 
terminal (s) 



Yes 



No 



Yes 



Partition using TP 
is causing loop 



Yes 



TP is causing loop 




No 




No 



No 



No 



Loop is in partition using TP 



Partition using TP 
is not causing the loop 



Inform terminal(s) that there will be TIME-OUT and that program using TP 
may have to be restarted or re-run at some other time, because of 
hands-on debugging procedures 



To part 4 of this chart 



To part 2 of this chart 




Yes 




No Loop; continue 
processing 



'\ ./ 



To part 4 of this 
chart 
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Unintended Loop 

CHART 04, PART 4 



From part 1 of this chart 



C 



Press STOP on all 
MICR/OCR devices 



Message 
INTERV REQ 
issued for MICR 
^OCR devices^ 



Yes 



No 



From part 1 , or part 3 
of this chart. 






Loop involves operation 
on MICR/OCR 



Trace loop by instruction 
step method. 



See D-4-F for Models 135, 138, 145, 148, 155-11 
and D-5-F for Models 155, 125 
and D-6-F for Model 158 



Note: 

It is important that at least 
15-20 instructions in the 
loop are noted. A trace of 
complete loop depends on 
time allowed for debugging. 



To part 6 of this chart 
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Unintended Loop 

CHART 04, PART 5 



From part 2 of this chart 



Pause all jobs to 
free a partition. 




<, y 



Press REQUEST 



X 



When Attention Routine 
is initiated (AR issued 
on SYSLOG), enter 
PAUSE BG, EOJ 
PAUSE F1,E0J 

PAUSE Fn, EOJ 

to pause all partitions. 



An EOJ is indicated by the SYSLOG message 

XX READY FOR COMMUNICATIONS 

(XX indicates the partition issuing the message). 




.,..; Where Fn is the highest 
^ numbered foreground 
1^; partition available in 
'■'the system. 

No 



Yes 



Execute the MAP 
command; refer to Section 
2, E-1. 



Before proceeding, check 
estimated job run time, either 
by contacting the programmer 
or from program run sheet 



To part 1 of this chart 




No 



For system programmers and IBM CE/SEs only. 

If possible assign SYSLST to a line printer on the 
partition being used to initiate SDAIDS. If a line 
printer is not available assign SYSLST to a tape 
unit or disk drive. (In the last case disk label 
information must be supplied.} 

Initiate SDAID BR trace between limits of partition 
owning failing program. Refer to B-10-F. (Partition 
limits can be obtained from the MAP output.) 

In conjunction with the assembly listing of the 
failing program you may be able to localize the 
error by scanning the SDAID output. 

You can further localize the error by adding IF, 
SA, and GA trace routines via CR9 and reducing 
the event limits via CR 10 and 1 1 . 



\ ,/ 



To part 6 of this chart 



.J" 
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Unintended Loop 

CHART 04, PART 6 



From part 5 of this chart 



At this stage, if only one job has not 
reached EOJ, it is possible that this job 
is causing the loop. Check estimated job 
run time with programmer or on 
program run sheet 







Yes 



From part 2 of this chart 



No 



More than one job stil 
running 






Loop is probably caused 
by this job 



No 




Let system continue 
processing. Programmer 
must immediately 
analyze the problem 



Trace loop either by 
instruction step (See 
note 1 ) or by using SDAI D 
routines B-10-F (See 
note 2) 



Yes 



From part 2 or 4 of this chart 




Execute a stand-alone dump 
as recommended in Section 2, 
A-3-F. On completion of the 
dump, re-IPL and obtain a dump 
or copy of the page data set as 
described in Section 2, C-6 



Turn to Section 4, 
Chart 01, Part 2 



I 



Save the following for the 
programmer: 

• SYS LOG output 

• Line printer output 

• Job stream 

• I/O files/volumes 

• Loop trace (instruction 
step or SDAID output) 

• Map, if applicable. 



I 



Note 1: 

See D-4-F for Models 135, 138, 145, 

148, 155-11 

and D-5-F for Models 1 15, 125 

and D-6-F for Model 158 

Note 2: 

SDAID should be used 
only by system programmers 
or by IBM CE/SE. 



Re-IPL: initiate 
different jobs 
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Obviously Incorrect Output 

CHART 05 



The identity of the partition using the device: 

This can be deduced from information given on 

the job run sheet, or the device ASSGN statements 

and commands issued on SYSLOG and SYSLST. 

An alternative method is to make the device producing 

incorrect output NOT READY. This will cause a 

device error recovery message to be issued on SYSLOG, 

Determine the partition using the device from the 
message printed on SYSLOG as a result of this action. 



BG 



0P08A INTERV REQ SYS008 = 



383 



Partition identity 



I/O Device Address 



If SYSLST for the partition to be dumped is not 
assigned to a line printer, use the line printer 
assigned as SYSLST on another partition. 
For example, DUMP F2S{BG). 
Note: This may produce dump output from the 
partition being dumped, interspersed with 
output from the program using the line printer. 



A System dump may be issued on the device assigned to 

SYSLST for the partition being canceled. 

(The System dump is described in Section 2, A-2.) 



CjEZ) 






If possible, contact the programmer 
to establish the expected output, 
and identify which job or partition 
is using the device that is 
producing the incorrect output. 



Make the device producing 
incorrect output NOT READY. 



Press REQUEST and wait for 
message 0P60 1 



V 



V 



Issue the Dump command 
to dump the partition and the 
supervisor, for example, DUMP 
F2S. SYSLST must be assigned 
to a line printer. 
Refer to Section 2, A-1 



Cancel the job in the partition 
producing the incorrect output 



Save the following information 
for the programmer(s). 

• SYSLOG output 

• Line printer output, including 
all dump output 

• Job stream 

• I/O files/volumes 
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Start 



Program Canceled 

CHART 06 



An informative message 
is issued on SYSLOG 
or SYSLST, or both 



QP73 1 JOB DEBUGEX8 CANCELED DUE TO I/O ERROR 
0S07 I PROBLEM PROGRAM PSW 03 1 0000000007 A02 



An example of a job cancellation 
message issued on SYSLST 



BG 0P24I C PROG CHECK SYS009=00D 

CCSW=00 1000022800200000 CCB=007A0E 

SN 8=000000000000000000000000000000000000000000000000 1 
BG 0P73IJOB DEBUGEX8 CANCELED DUE TO I/O ERROR 



o 



An example of a job cancellation 
message issued on SYSLOG 



A system dump is issued 
to the device assigned as 
SYSLST 




A system dump is issued to SYSLST under the 
following conditions 

1. The supervisor in use supports the OPTION DUMP, 
which is not overruled by the job control statement 
// OPTION NODUMP in the job stream. 

2. The job control statement // OPTION DUMP is 
included in the job stream. 

For a complete description of the system dump, refer 
to Section 2, A - 2. 



No 



Yes 



Dump the disk extent, or 
tape assigned as SYSLST 
to obtain a printed dump 



Execute the 
Map command 
(refer section 
2, E-1) 



Save the following information 
for the programmer: 

• SYSLOG output 

• Line printer output, includ- 
ing any error message and 
the system dump 

• Job stream 
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FOR YOUR NOTES ^-^ 



^\^ y 
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DOS/VS Serviceability Aids and Debugging I'rcicedures 

SECTION 4 



DEBUGGING FOR 
PROGRAMMERS 



f\ 



Debugging for Programmers 4. 1 



Section 4, DOS/VS Serviceability Aids and Debugging Procedures 



DEBUGGING 
PROCEDURES 
FOR SYSTEM 
PROGRAMMERS 



How to use 

The choice of serviceability aids and methods of off-line program debugging and of 
analyzing each programming error rests with the programmer. The flowcharts in 
this section, however, will help the programmer to choose the method best suited to 
the type of error. For efficient analysis of dumps, program output, and printouts, 
an understanding of DOS/VS information blocks and supervisor interface tables is 
required. This section describes how your programs, referred to as user programs, 
interface with the IBM System Control Programs (SCPs). It also illustrates the 
allocations of storage, program and supervisor save areas, and details the informa- 
tion contained in the interface tables useful for program debugging. 

The debugging of user programs written in a high-level language or for use with 
teleprocessing are not discussed. However, the serviceability aids described in 
Section 2 and the operator procedures of Section 3 should be used initially to 
gather information from the system. Having obtained the information, the procedures 
in this section can then be used in conjunction with the debugging procedures 
described in the applicable high level language or teleprocessing component manuals. 

This Section is divided into two parts. The first part consists of checklists in the 
form of flowcharts that should be used as a guide during offline program debugging. 
They help in selecting a method of analysis, and if required, help in the choice of 
the serviceability aid for further error isolation. 

The second part of this section consists of a general description of the DOS/VS 
supervisor tables, information blocks, and save areas, together with other system 
information useful for offline debugging. More details about these tables and areas 
can be found in the IBM publication DOS/VS Supervisor Logic. 

Note: It is assumed that the programmer using this section is familiar with DOS/VS 
multiprogramming, asynchronous processing (multitasking), relocating load, virtual 
storage, and data management techniques. These techniques are described in the 
DOS] VS System Management Guide. 






'\^,^y 
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4.2 Debugging for Programmers 



Section 4, Part 1 

CONTENTS 






Flowcharts for offline debugging 

1. Initial checks on the program and its input 44 

2. Programming errors that generate problems during IPL 47 

Isolating errors that cause the system to enter a WAIT STATE. 

3. HARD WAIT STATE with a coded message in low address storage 4.9 

4. HARD WAIT STATE with no coded message in low address storage 4.10 

5. SOFT WAIT STATE 4.11 

6. Isolating errors that generate unintended program loops 4.13 

7. Isolating errors that produce incorrect output that is detected after an 

indefinite time since execution of the program 4.14 

8. Isolating errors that produce incorrect output that is detected either during, 

or immediately after execution of the program 4.15 

Isolating errors that cause program/fob cancellation: 

9 Because of a PROGRAM CHECK in a user written program 4.20 

10. Because of an ILLEGAL SVC 4.25 

11. For other reasons 4.26 

12. Because of a PROGRAM CHECK within the supervisor area 4.27 

POWER/VS 

13. Problem analysis for programs running under POWER/VS 4.30 



o 
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Initial Checks 

CHART 01, PARTI OF 2 






Start 



Program Error 
recognized by: 



Operator 
not able 
tolPL 



Operator during 
execution of 
job/program 



Error during IPL 



System entered 
a wait state 



Incorrect output 
detected at some 
time after running 
the job/program 



Turn to chart 07 
in this Section 



Unintended loop 
developed 



Program produced 
obviously incorrect 
output 



Job/program 
canceled 



The operator should supply this data gathered from the system when the error occurred 



SYS LOG output. 
Dump, or note of 
low address storage 
bytes X'OO' - X'BF' 
Stand-alone dump. 
SYSRES pack in use 
when error occurred. 



SYSLOG output. 
Dump, or note of low 
address storage & current 
PSW. 

Stand-alone dump. 
Dump or copy of SYSVIS. 
Any line printer output 
when error occurred. 
Job stream. 
Note of I/O files/vols. 
SEREP/EREP output 
if applicable to cause. 



SYSLOG output 

Partition dumps, if any 

taken. 

MAP of system. 

Job stream. 

Any line printer output 

when error occurred. 

Stand-alone dump. 

Dump or copy of SYSVIS, 

Loop trace, either 

manual or SDAID. 



SYSLOG output 
Line printer output, 
including the dump 
of the partition using 
the device producing 
incorrect output, 
A dump of the 
supervisor, or a 
System dump. 
Job stream. 
All input/output files/ 
vols, used by the 
partition dumped. 



SYSLOG output 
System dump (if 
executed). 
Any line printer 
output from Job, 
including any 
messages , 
Job stream. 






Th6 application programmer should supply you with this data to aid problem analysis 



As the system programmer 

/ou may require: 
Supervisor listing 
of supervisor in use. 
Linkage editior map 
for the supervisor 
in use when error 
occurred. 



Program listings of 
all programs being 
executed when error 
occurred. 

Linkage editor maps 
for the programs. 
Supervisor listing for 
supervisor in use. 



Program listing of the 
program in which 
loop developed 
(If loop was not 
isolated to a partition, 
program listings of all 
programs being 
executed when loop 
occurred may be 
required,) 

Linkage editor map 
for program(s). 



Program listings. 
Linkage editor map. 



As the system programmer 
you may require: 

Program listings. 
Linkage editor map. 
Supervisor listing. 



Turn to chart 02 
in this Section 
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To part 2 
of this chart 



From part 1 
of this chart 



A I 

Y 



r~ Check 1 ~1 
[ Error messages [ 



I — Check 2 — i 

Program execution 



— Check 3 — i 

Program, or module 
(sub-routine) coding 



r- ' 

in 



Check 4 

put media 



- Check 5 

input/output 
device and type 



~ Check 6 

DOS/VS level of 
release 



Check 7 

Job control 
statements 



- Check 8 — 

System hardware 
configuration 



- Checks — r 

Categorize error 



Initial Checks 

CHART 01, PART 2 OF 2 



Look for messages on console printer log sheet, or 
line printer output associated with the job in error. 



Consult "Programmer Action" listed in 
DOS/VS Messages. If solution to 
problem not found, return to check 2. 



No 



Has the program ever run successfully? 



M 



Yes 




% Has there been a reassembly of the program, or any 
module used by it, since the previous run? 

• Has the program or any module used by it been 
recataloged since previous run? (For example, 

a change in LOAD or ENTRY addresses.) 

• Has any coding been changed by REP or SOURCE 
cards? 

• Has an IBM programming temporary fix (PTF) 
been applied to the program, or any of its modules? 





• Has there been any change in the location of data 
on any of the input files? (For example, the area 
containing the data on a disk pack has been moved 
to another address either on the same pack, or on a 
different pack.) 

• Has there been a change in any input media? (For 
example, input data was previously on cards, but has 
since been transfered to disk pack.) 



Was a different physical input/output device type 
assigned? (For example, in the previous run, l/Q 
device was a 3330 disk drive, but is now a tape unit.) 




• Did the program run previously under the same 
DOS/VS release? 

• Was the same supervisor used for both runs? 

• Have there been any changes to the supervisor, since 
the previous run? (For example, re-system generation) 



Has there been any real change in job control since 
previous run? (For example, a change in the // EXEC 
parameter to REAL from default.) 



Was the program executed on a different system 
configuration from the previous run? 
(For example, a different model of CPU.) 




■Program error recognized by: 
WAIT state 



LOOP 

Obvious incorrect output 
Job/program canceled 



Go to check 9 



Go to check 3 and continue through 
this checklist. It is recommended to make 
a copy of this chart and make notes 
(for future reference) in this column 
of any differences from previous 
execution of the program. 
At this stage there is no need for further 
action, unless the solution to the problem 
becomes obvious. 





Turn to chart 03 
Turn to chart 06 
Turn to chart 08 
Turn to chart 09 
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4.5 






Intentionally Blank 



V,-^' 



>/ 



4.6 Debugging for Programmers, part 1 



Errors during IPL 

CHART 02, PART 1 OF 1 



Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 



Check 1 










Supervisor listing 




If the IPL procedure can not be completed 
and the supervisor in use has never been used 
on the system, check the supervisor assembly 




If the cause of the error can not be isolated, 
inform IBM and have the following informa- 
tion available: 












listing for flagged statements. Also note in 




• The supervisor listing 




the listing the options supported by the 




• The stand-alone dump output, including 




supervisor. 




the dump of the low address storage 




Check that the hardware is present in the 




• The SYSRES pack used when the error 




system for options supported by the super- 




occurred 




visor that require hardvuare support. 




• Any notes about actions taken during 
error analysis both on and offline. 




Also check that the supervisor is generated 








to support hardware options that are present 
on the system. 















o 
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Hard Wait Message Codes 
SUPPORT FOR CHART 03 



BYTEO 


BYTE 1 


BYTE 2 


BYTES 


EXPLANATION 


MCH/CCH/IPL Hard Wait Codes placed in low address storage 


x'cr 


X'E2'(2) 


A,I,S(1) 


Not used 


Irrecoverable machine check. 


X'C2' 


X'E2'(2) 


Not used 


Not used 


Irrecoverable channel failure during RMS fetch. 


X'C3' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure on SYSLOG when RMS message scheduled. 


X'C4' 


X'E2'(2) 


A,I,S(1) 


Not used 


No ECSW stored 


X'C5' 


X'E2'(2) 


A,I,S(2) 


Not used 


Channel failure: ERPBs exhausted. 


X'C6' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure; two channels damaged or a damaged channel situation occurred while RMS 
was executing an I/O operation. 


X'C7' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure; system reset was presented by a channel. 


X'C8' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure; system codes ECSW are invalid. 


X'C9' 


X'E2'(2) 


A,I,S(1) 


Not used 


Channel failure; channel address invalid. 


X'DI' 


X'E2'(2) 


A,I,S(1) 


Not used 


Irrecoverable channel failure on SYSVIS. 


X'07' 


X'E6' 


Channel 


Unit or 
X'OO' 


IPL I/O error or equipment malfunction; condition code 2 during STIDC instruction, 
Channel and unit indicate whether device in error is SYSRES or communication device. 
When byte 3 = X'OO', bute 2 indicates the channel for which STIDC instruction was 
issued. Re-IPL system. 


SDAID Hard Wait Code | 


X'61' 


X'E6'(3) 


Channel 


Unit 




Another device is running in burst mode on same channel as SDAID output device. 
Re-IPL svstem. 


SDAID Soft Wait Code | 


X'62' 


X'C5' 


Not used 


Not used 


SDAID output device became unready. Make printer ready and press the EXTERNAL 
INTERRUPT key. 


X'OO' 


X'00'(3) 


X'OO' 


X'OO' 


SDAID Stop on Event. Press EXTERNAL INTERRUPT key to continue 
operations. 


The folic 


wing Hard 


Wait Code 


s are place 


n general register 1 1 X'B' as well as in low address storage. 


X'OO' 


X'OO' 


X'OF' 


X'FF' 


Program Check in Supervisor. 


X'OO' 


X'OO' 


X'OF' 


X'FE' 


I/O error during fetch from System CI L. 


X'OO' 


X'OO' 


X'OF' 


X'FD' 


Channel Failure if MCH=NO and RMS=No is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FC 


Machine Check if MCH=NO and RMS= No is specified during system generation. 
(Models 115 and 125 only). 


X'OO' 


X'OO' 


X'OF' 


X'FB' 


Page Fault in Supervisor routine with identifier RID X'OO' 


X'OO' 


X'OO' 


X'OF' 


X'FA' 


Translation Specification Exception 


X'OO' 


X'OO' 


X'OF' 


X'F9' 


Error on Paging I/O. 


X'OO' 


X'OO' 


X'OF' 


X'F8' 


CRT phase not found. 


X'OO' 


X'OO' 


X'OF' 


X'F7' 


No copy blocks available for BTAM appendage I/O request. 


X'OO' 


X'OO' 


X'OF' 


X'F6' 


$MAINDIR canceled during system CIL update. 

If this occurs, the system CI L is only partially updated and must be restored before use. 
This hard wait condition can also occur if the FETCH QUEUE BIT (FCHQ) is set in the 
linkage control byte in the partition communication region owned by the 
terminating partition. 


X'OO' 


X'OO' 


X'OF' 


X'F5' 


TFIX count outside limits. 


X'OO' 


X'OO' 


X'OF' 


X'F4' 


$$A transient not found (the transient name can be found in ERBLOC). 


X'OO' 


X'OO' 


X'OF' 


X'F4' 


No recovery possible from CRT errors. 


Device E 


rror Recov* 


jry Soft W 


ait Codes p 


laced in low address storage. 


X'08' to 


X'CI'or 


Channel 


Unit 


Error recovery messages. Refer to chart E-3-F. 


X'60' to 


X'C4' 












\_f' 



Notes: /. A(X'CI') = SYSREC recording unsuccessful. 
I (X'C9') = SYSREC recording incomplete. 
S (X'E2'} = SYSREC recording successful. 

2. S(X'E2') - Run SEREP. 

3. SDAID wait states are identified by X'EEEE' 
in the address part of tfie wait PSW. 

Refer to Section 2-E-3 for a list of IPL error message codes and a more detailed description of wait states. 
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rhprk 1 










Eliminate components 




Was POWER/VS initiated when the wait state 

occurred. 

Establish this from the SYSLOG logsheet, 

or the operator concerned. 


Yes 


Examine bytes 0—3 of low address storage 
noted by the operator and the contents of 
GPR 1 1,X'B' in the dump output. Compare 
the contents with the coded messages 
listed on the opposite page. 

• If the code is listed analyze the program 
further based on the reasons given against 
the codes in the list. 

• If the code is not listed, turn to chart 13. 


























No 


Go to check 2. 






"^ 



Check 2 

Type of Wait 



o 



__ Check 3 , 

Analyze message in 
low address storage 



_ Check 4 . 

Locate old PSW 



- Check 5 — 

Locate failing 
instruction address 



HARD WAIT STATE 



SOFT WAIT STATE 
(You may require an interview with the 
operator to verify if this type of wait 
occurred, and request information about 
system occurrence and messages printed 
prior to the wait state.) 



Use the dump, or notes made by the 
operator, of low address storage and current 
PSW, and the list shown on the opposite 
page. Also, refer to section 2-E-3. 
Analyze the message in bytes 0—3 to 
isolate a possible cause of the error. 



Use the stand-alone dump output to locate: 

• the old PSW applicable to the message. 

• the instruction length code (Refer to 
section 2-E-2.) 

• the interrupt code. 

The reason for the error may be that a 
transient used by the program is not 
cataloged in the system core image library. 
Execute DSERV, (Refer to section 2-C-2.) 



Use the stand-alone dump output and 
supervisor listing to locate where in the 
supervisor the program check occurred (which 
routine). Analyze the failing instruction 
and compare the code of the instruction 
in the dump with the instruction in the 
listing. 



Proceed to check 3. 



•!►■ Turn to chart 05. 



If GR 1 1 contains a hard wait code (see table 
opposite) or a hard wait code exists in bytes 2 
and 3 of low address storage, proceed to check 4, 
If there is no recognizable message turn to 
chart 04. 



Calculate the failing instruction address by 
subtracting the length code from the instruc- 
tion address part of the PSW. Analyze the 
cause of the program check using the 
interrupt code. If you cannot isolate the 
error with this information proceed to 
check 5. 



Make certain that user routines have not 
altered the supervisor, and that the super- 
visor assembly is free of error. Before 
calling for IBM programming support, 
execute the program with PDA ID F/L trace 
on all partitions to trace phases used. (Refer 
to section 2-B-2.) 

Also, use the SO AID stop on event program 
check and obtain a non-destroying dump 
when the stop occurs. (Refer to section 
2-B-10). 

If the error cannot be isolated after re- 
analysis of the problem using the output 
obtained from the re-run, inform IBM. 
Have the following information available: 

• SYSLOG output 

• Supervisor listing 

• Program listing 

• Linkage Editor maps 

• Stand-alone dump 

• Dump or copy of SYSV IS 

• PDAID and SDAID output 

• Job stream 

• DSERV output if one was obtained. 
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Chock 



Scan the stand-alone 
dump output 



A. Look for unexpected or unreasonable 
values in the following areas in the dump 
output: 

• PSWs in low address area (machine check 
old, program old, input/output old, SVC 
old, external old), and note interruption 
codes for the associated PSWs. 

• General purpose registers. 

• Control registers (see appendix C). 

• CSW and CAW (refer to section 2-E-2). 

B. If the dump produces a formatted output, 
scan the LUB, PUB, CHANQ, PIB, and 
ERRORQ. (Refer to chapter 3 in this 
section for a description of these supervisor 
tables.) 

C. Locate SYSCOM (address of SYSCOM is 
found at location X'80-83' of low address 
storage.) 

D. Locate the logical transient area. The 
address of the LTA is found at X'lC of 
SYSCOM. 

Convert the first eight bytes of the LTA to 
characters. This is the name of the transient 
in the LTA at the time the dump was taken. 
If it is a user-written transient, obtain a 
listing of the transient and check for the 
use of SVC22 (Seize System). When the 
system is seized, no interrupts can occur 
until a second SVC 22 is issued to release 
the system. If the transient is supplied by 
IBM, inform IBM and have the following 
available: 

Supervisor Listing, Stand-alone dump, 
Jobstream, Program Listing, Linkage Editor 
maps, and SYSLOG output. 



If the error cannot be isolated, re-run the 
program with SDAID IF trace function. 
Use FASTREC output class and specify 
as large an area as possible for SDAID 
(refer to section 2-B-10) 

Proceed to check 2, 



Check 2 










Analyze the 




Use the SDAID IF trace output to determine 
where the LPSW (load program status word) 




Compare the last few instruction addresses in 


SDAID output 






the IF trace output with, for example, the 






was given. The HARD WAIT is caused by a 
LPSW instruction that can be issued only 




supervisor listing, or if the instruction 
addresses are not in the supervisor area, the 








whien the system is in the supervisor state. 




listing of the IBM routine which was running 




For example, LPSW can be issued by the 




in supervisor state. Determine the routine in 




DOS/VS supervisor or any IBM routines that 




which the LPSW is issued. 




run in supervisor state. 




Inform IBM and have the following informa- 
tion available: 






• SYSLOG output 




• List of the IBM routine in which the LPSW 




Instruction is issued, for example, the 




supervisor listing 




• Stand-alone dump output 




• SYSVIS dump or a copy of the PDS on 




tape or disk 










• SDAID IF trace output 



J 
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Establish task(s) 
waiting for input/ 
output interrupts 



Use the stand-alone dump output to locate 
the PIB. Make a note of the flag byte and 
address of the partition save area for each 
entry in the PIB. (How to locate the PIB and 
analyze information aantained in an entry is 
described in Chapter 7 in this Section.) 



M 



Proceed to check 2. 



Check 2 



Determine status of 
the partitions 



A. Determine the status of each partition by 
analyzing the flag byte. For example, a 
flag byte containing X'82' indicates that 
the task is waiting for an input/output 
interrupt. 

B. Locate the partition save area of each 
partition and make a note of the return 
PSW in each of the save areas. (Refer to 
chapter 1 1 in this Section.) 



Use the instruction address part of each 
return PSW to locate the instruction (in the 
dump) which will be executed when the 
partition regains control. If the sequence of 
instructions in the dump starting at this 
instruction is TM, BO, SVC 7, proceed to 
check 3. Otherwise go to check 4. 



Check 3 



Analyze the contents 
of general purpose 
register 1 



Determine if the contents of general purpose 
register 1 in the partition save area is pointing 
to a CCB. An example of a valid CCB is shown 
in Chapter 5 in this Section. 



If GR 1 is not pointing to a valid CCB proceed 
to check 4. 

If the contents of GR1 is pointing to a valid 
CCB, analyze the contents of bytes 2, 3, and 
1 2 of the CCB. (Refer to Chapter 5 in this 
Section for a description of the format and 
contents of the CCB). 

If the CCB is posted, check the seek address 
and unit check bits in the CCB. If you are 
using user-written unit check procedures, 
check that the sense data is properly tested. 

If the CCB is not posted, the device using this 
CCB is waiting for an input/output interrupt. 
Go to check 5. 



Check 4- 



Analyze the program 
or programs running 
when the wait state 
occurred. 



Use the program listing and linkage editor 
map* for each of the programs that were 
running, and, in conjunction with the instruc- 
tion address part of the return PSWs in the 
associated save areas, locate the instruction in 
each of the programs. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 



Determine the routine that was being executed 
in each of the programs running when the wait 
state occurred. Check the instruction coding in 
each routine for the correct use of macros, for 
example, the use of ENQ, DEQ, and WAITM 
macros. (A task may be waiting for a particular 
resource, or there may be atprogrammed WAIT 
for a timer control block.) 

If the track hold facility is supported, check 
that the maximum number of tracks specified 
in the TRKHLD parameter is not exceeded. 
Also ensure that one task is not waiting for 
tracks held by another task. 

For details about these macros and their for- 
mat refer to the IBM publication DOS/VS 
Supervisor and I/O Macros, and for examples 
of the use of these maaos and multitasking, 
refer to the DOS/VS System Management 
Guide. 

If the error can not be isolated, proceed to 
Check 5. 
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Check 5- 

Analyze the last 
START I/O 



Inspect the channel bucket and analyze the 

contents to obtain infornnation about the last 

input/output operation started on each 

channel. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 6. 



Check 6 

Determine the I/O 
device involved 



^~\-^ 



A. Locate the associated PUB entry to 
deternnine the device address. (Refer to 
Chapter 3 in this Section.) 

B, Locate the associated LUB entry, (and the 
JIB if necessary), to determine the logical 
unit involved. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 7. 



Check 7- 



Establish if there are 
other requests for the 
same device or if the 
CHANG is full 



► Locate the channel queue, and check if any 
other input /output requests are queued for 
the same device. 

► Check the contents of FLPTR, if it is 
X'FF' the CHANQ is full . This may be an 
indication that the CHANQ is too small for 
the type of programs in use. 

(Refer to Chapter 3 in this Section.) 



Proceed to check 8. 



V..,> 



-Check 8 



Inspect the ERROR 
QUEUE 



Locate the error recovery block and check if 
there are any entries in the error queue for 
the device. 

From the error queue entry you can obtain 
the CSW, CCB address, and Message Code. 
Use the message code to locate the meaning 
and possible cause of the message by referring 
to the DOS/VS Messages manual. 
(Refer to Chapter 3 in this Section.) 



If the error can not be isolated, inform IBM 
of the problem, and have the following 
information available: 

• SYS LOG output 

• Stand-alone dump 

• SYSVISdumpor copy of the PDSon tape 
orvXJisk 

• Job stream 

• Description of systenfi environment and 
conditions under which the program is 
executed. 

Otherwise make corrections to your program 
as necessary. (This may require a new 
assembly of the supervisor, or re-running 
the program using a supervisor that can 
accommodate the required input/output 
operations.) 
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Unintended Loop 



Check 



Check 1- 



Approximate location 
of tiie loop 



Check 2 



Eliminate 
components 






— Checks - 

Preparation for 
problem analysis 



Method of Analysis 



Use the trace of the loop (SDAID BR trace 
output or manual trace) and any notes made 
by the operator to inspect the path made by 
the loop. Also, use the linkage editor map and 
stand-alone dump to check if the loop 
addresses are within the DOS/VS supervisor 
or in the POWER/VS partition (if POWER/VS 
was initiated when the malfunction 
occurred) or in a module used by the 
program. 



• Is the loop in a user written module? 



Yes 



• Are any other programs using the same 
module 



Yes 



• Did these programs tnat use this common 
module generate unintended loops? 



Yes 



No 



If the loop is in the program, use the pro- 
gram listing, the trace of the loop, stand- 
alone dump, and program logic charts for 
analysis. 

If the module is suspected of causing the 
loop, use the listing and logic charts of the 
module for analysis. 



Also, check if any changes have been applied 
to the module since the last time the program 
ran successfully. 



No 



No 
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If the loop is entirely within the DOS/VS 
supervisor or the POWER/VS partition or 
in an IBM module used by the program or 
in an IBM written program, inform IBM 
and have the following system information 
available: 

• SYS LOG log sheet 

• Any output from the program 

• Job stream 

• Trace of the loop (SDAID output 
if possible) 

• Stand alone dump 

• SYSVISdump, orcopy of the PDS 

• DOS/VS supervisor listing and the 
POWER/VS listing (if applicable) 

If the loop is not in the supervisor or the 
POWER/VS partition, or only part of it 
is, proceed to check 2. 



Loop is caused by the program. Proceed to 
check 3. 



Suspect the module of causing the loop. 
Proceed to check 3. 



Loop is very likely generated by the module. 
Proceed to check 3. 



proceed to check 4. 



Remove the changes and re-run the program. 
Otherwise, proceed to check 4. 



Check 4 



Program and problen 
analysis 



A. Check program listing and logic flow for: 

• Count locations that can never reach 
their limits. 

• Counters that are not updated. 

• Counters that are never initiated. 

• Count locations, the contents of which 
are not periodically or properly tested. 

• Check that 1/0 operations are able to 
reach their completion, and are not 
prevented from doing so by program 
logic. 

B. Check the counter locations in the stand- 
alone dump. They may have been over- 
written, in which case use the program 
Usting to isolate the point in the program 
where the locations are prepared. 

Note: Examine the channel programs if I/O 
operations are directly responsible for 
preparing count locations. 



If error, cannot be isolated, re-run the program 

using SDAID BR and/or IF trace functions to 

obtain a complete trace of program and 

module logic flow during program execution. 

(Refer to Section 2-B-10.) 

Also, use PDAID F/L trace to check phases 

used by the program. (Refer to Section 2-B-4.) 

Re-analyze the problem. 

If the error can not be isolated, inform IBM. 

Have the following system information 

available: 

• SDAID output 

• SYSLOG output 

• Job stream 

• Program listing 

• Listing module used (if module suspected) 

• Trace of loop 

• Stand-alone dump 

• S YSV IS dump or copy of PDS on tape or 

disk 

• PDAID output. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 






1 Check 1 1 

Gather any information 
pertaining to program 




A. Ascertain System Environment (Super- 


1 




Turn to check 1 of chart 06 and analyze the 
problem using all available information. 
Try to simulate the same conditions for a 
re-run of the program. 
Use chart 06 for error isolation. 




visor, DOS/VS release number, I/O 
devices used, modules used, etc.) 
B. Obtain SYSLOG output from the job,and 
if possible the input job stream and input 










files. (This depends on may circum- 
stances, such as time involved, storage of 
output from previous runs, original input 
files already overwritten for other jobs 
etc.) 
C. Program listing and linkage editor map. 










D. Ascertain the status of the machine at the 
time the job ran. For example, find out if 
an I/O unit in use for the program 
developed an error and analyze its effects 
on the program. 






Re-run program; execute a system dump 
or stand-alone dump when incorrect output 
is detected. 























^... -jr 
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Check 1 

Environment 










Turn to chart 13. 




Was the program operating under POWER/VS 






L_ — __ -, , 


t- 











Proceed to checi< 2. 





Check 2 



Type of program 
producing the 
incorrect output 






Userwritten? 




Proceed to check 3. 








IBM-supplied program? 

Assembly language compiler 

High level language compiler (RPG II, 

FORTRAN, etc.) 

IBM library program (DSERV, SORT/ 

MERGE) etc. 


Inform IBM and have the following informa- 
tion available: 

• All output from the program 

• SYSLOG output 

• Job stream 

• Input files 

• Supervisor generation notes and level of 
release 

• Listing of the support for the failing 
program 

• Notes about system type and model, and 
any notes about system status and input/ 
output units used for the program. 









Checks — 

Type of incorrect 
output 



Use any output from the program and 
messages printed during program execution 
to determine the type of incorrect output 
according to the following categories: 



• Duplicate (identical lines printed). 



• Lack of (missing data printed). 



Too much or unexpected (more data 
printed than expected). 



Use the program listing and analyze the 
coding, checking for: 

» Unnecessary program loops in input/ 
output routines 

» Routines not being entered or completed 

• Overlaid input/output areas. 

If necessary, re-run the program using 
SDAID IF, SA, and GA trace functions. 
Specify event limits that will adequately 
cover routines that prepare output areas. 
(Refer to section 2-B-10) 
Re-analyze the output from the re-run. 
If the error can not be isolated proceed to 
check 4. 
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'L.J 



Check 4 

System condition 
during program 
execution 




Were there any abnormal interruptions in 
computer operations during execution of 


Yes 


Analyze the possible effects of any interrup- 
tion, and re-run the program ensuring no 
interruptions. 




the program? 










No 








Were any abnormalities observed in system 
actions or response to messages by the 
operator during program execution? 


Yes 


Re— run the program and note any unexpected 

system actions. Ensure the correct response is 

given to messages issued. (Refer to the DOS/VS 

Messages manual). 

Use any notes made to analyze program logic. 

If necessary, re-run the program using 

the SDAID IF trace to aid analysis of program 

logic. 

Check the input used for the program. 

Proceed to check 5. 












No 









-Check 5 

Job stream 



Check that the correct job stream was used for 
the program. This applies also to job streams 
cataloged on the procedure library. 
(Use PSERV to display the procedure 
library; refer to section 2-C-3.) 




If error isolated, make corrections as 
necessary and re-run the program. 

If error can not be isolated, proceed to 
check 6. 





-Check 6 

Input used 





A. Isolate suspected areas on the input files 
by examining the output from the 
program. For example, a missing record 
in the output indicates the approximate 
area on the input file that may be in error. 




A. Obtain a dump of suspected areas on the 
input files used. For VSAM files use the 
Access Method Services utility program 
PRINT command. (Refer to section 2-C). 

B, Check input/output file macro 
definitions in the program listing against 
characteristics of data on the input files. 
DTF (LIOCS), CCB (PIOCS) 

ACB, RPL, and GENCB (VSAM). 

Compare the output of the LSERV, LVTOC, 
and LISTCAT programs with DLBL/EXTENT, 
VOL ID, data in the job stream. 
If no errors can be found, proceed to check 7, 














B. Check the labels and volume ID and extent 
information. Use LSERV and LVTOC, or 
for VSAM files use LISTCAT Access 
Method Services utility commands. 









y 
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■ Check 7— 

Dump of partition 



Did the operator obtain a dump of the 
partition containing the failing program? 
For example, a stand-alone dump, a system 
dump, or a dump obtained by using the 
DUMP command. 



Yes 



Inspect input/output areas in the dump, also 
inspect CCBs and channel programs. (Refer to 
chapter 5 in this section.) 
If no errors are found proceed to check 8, or 
if satisfied with the information that can be 
obtained from the dump go to check 10. 



No 



Proceed to check 8. 



Check 8 ■ 

Obtain a non- 
destroying dump 



o 



Use the program listing and the information 
already obtained from the previous analysis 
of the problem to isolate the approxinrrate 
area of the failure. 

For example, a specific input/output area, 
or a specific vwork area. 



-A. Re-run the program with SDAID IF and/or 
SA trace function. Specify a stop on event 
and obtain non-destroying dumps at specific 
instructions, or specific storage alterations. 
(Refer to section 2-B-10.) 

B. Also, as a further aid for problem analysis, 
use the PDAID F/L trace to trace phases 
used by the program. 

Proceed to check 9. 



Check 9 



Analyze the SDAID 
dump output 



A, inspect input/output areas, CCBs, and 
channel programs in the non-destroying 
dump output. 

B, Compare input/output areas as defined 
in the DTFs, CCB and CCW macros, and 
ACB, RPL and GENCB macros in the 
program listing, with the areas as printed 
in the dump. 

C. Check the sequence, names, and load/ 
entry addresses of the phases used by the 
program, and compare them with the 
linkage editor map addresses, 

D. Use the program listing and dump output 
to inspect values in registers and storage 
locations used for intermediate results. 



if no errors can be found and the cause of the 
error can not be isolated, proceed to check 10. 
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Check 10 



Unusual conditions 
generated by the 
program and its input 



Checi< that the program logic and counters can 
accommodate unusual conditions and circum- 
stances of input. For example, data changes 
. (year), or extraordinary changes in amounts 
and quantities. 



If the error can not be isolated, proceed to 
eheck 1 1 . 



Check 11- 

Preparation of the 
input files 



Check the input used for this program. If 
necessary, analyze the program that prepared 
the input files, starting at check 1 of this 
chart. 



If the input is correct, and the program that 
generated the input is not at fault, proceed 
to check 1 2. 



Check 12- 



Gather more system 
information 



Re-run the program, using, if possible, newly 
prepared input data that is known to be correct 
Try to simulate or run under identical condi- 
tions to those in which the failure occurred. 



A. Re-run the program with the PDAID F/L 
trace, to trace phases used by the program. 
(Refer to Section 2-6-4.) 

B. If you have not carried out the recommen- 
dations listed in checks 8 and 9 of this 
chart, initiate the SDAID IF, and/or SA 
trace functions. Use specific addresses for 
the event limits that are related to the 
problem, based on your previous analysis. 
(Refer to Section 2-B-10J 

C. Before re-running the program, re-assemble 
it using the PDUMP macro to dump all 
input/output areas before and after every 
input/output operation. 

(Refer to Section 2-A-5.) 

If the program is using VSAM files, re- 
assemble the program and insert the 
TESTCB or SHOWCB macros, before 
and after each OPEN, GET and PUT. (Refer 
to Chapter 4 in this Section.) 

If, after re-analysis of the problem using the 
output from the re-run, the error can not be 
isolated, inform IBM and have the following 
information available: 

• All program output, whatever it is 

• All dump output 

• SDAID/PDAID output 

• SYSLOG output 

• Job stream 

• Any notes pertaining to the problem 

• Notes about system environment and 
condition. 



\,^ ,y' 



v™>^ 
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Check 

Check 13 

Eliminate 

components 

used. 



Method of Analysis 



I Without initiating a POWER/VS partition or 
running under POWER/VS RJE re-run the 
program producing the incorrect output. 



\ Are other programs generating incorrect 
output when running under POWER/VS or 
POWER/VS RJE 



Recommendations to Aid 
Further Problem Analysis 




If program still generates incorrect output, 
analyze the problem starting at check 1 of chart 
06, part 1 '. Otherwise suspect the POWER/VS or 
POWER/VS RJE partition and proceed to check14 



Proceed to check 1 4 



— Check 14 — 

Programs failing 
which run under 
control of POWER/VS 
or POWER/VS RJE 



Inspect the contents of general purpose register 
7 printed at the beginning of a system dump or 
stand-alone dump executed just before the 
malfunction occurred. This register should 
contain the address of the TIB of the active 
POWER/VS or POWER/VS RJE routine just 
before the dump was executed. 






if the program is run under' POWER/VS 

refer to Appendix L. 

By using the system information and Appendix L 

(as applicable), you may be able to 

isolate the cause of the error. In any case it is 

recommended that you inform IBM of the 

problem and have the following information 

available: 

• SYSLOG output 

• Stand-alone dump 

• A dump, or copy of SYSVIS 

• Dump of the QFILE 

• Supervisor assembly listing 

• POWER/VS SCP assembly listing 
' • Job stream 

• Any notes made during system operation 
when the malfunction occurred. 

You may re-run the program under POWER/VS 
lor POWER/VS RJE with the following aids 

A. Use PDAID I/O or QTAM trace functions to 
trace I/O operations on all units used by the 
program producing incorrect output, and by the 
partition owning POWER/VS /POWER/VS RJE 
(refer to section 2-B'-4) 

B. Use SDAID BR function on the partition ' 
owning POWER/VS to trace the logic flow during 
program execution (Refer to section 2-B-10). 

C. As an option, re-run the program using 
PDAID F/L trace on the partition owning 
POWER/VS to trace phases used. 
(Refer to section 2-B-4). 



Debugging for Programmers, part 1 4.19 



Program canceled by Program Check 

CHART 09, PART 1 OF 4 




Me thod of A nalysis 



Recommendations to Aid 
Furtlier Problem Analysis 



Program Check. 



Proceed to check 2. 






•H Illegal SVC. 



Check 2 



Area of failing 
instruction 
(Level 1) 



Check 3 



Area of failing 
instruction (Level 2) 



Check 4 



Location of failing 
instruction 



Other (for example, operator cancellation). 



"] ^ f Turn to chart 10. 



Is message 1Q30D ABNORMAL 
POWER/VS TERMINATION. 
PRINTER = 

issued on SYS LOG just after 
the program check message? 



No 



Is the program check in the SVA? 
There are two methods to establish this: 

1 . From the MAP command output check if 
the instruction address shown in the Program 
Check message is within the SVA. 

(The MAP command should have been issued 
by the operator immediately after the Program 
Check occurred) 

2. If a System Dump was executed when the 
Program Check occurred and the Program 
Check was in the SVA, a dump of the SVA (or 
part of it) will be preceded by the following 
message printed in the dump output: 

PART OF SVA WHICH CAUSES ERROR 



T 



No 



Use the load and entry addresses of phases and 
modules used by the program as indicated on 
the linkage editor map, * and the error message 
to locate in which area the program check 
occurred: 



' Program check in user program area 



* Program check within the supervisor area 
(The address of the end of the supervisor is 
contained in bytes X'20'-X'23' of SYSCOM 
and the address of SYSCOM is contained in 
bytes X'80'— X'83' of the low address storage) 



• Program check within the partition 
containing the POWER/VS SCP or 
POWER RJE system control programs 



Use the linkage editor map as in check 2 above, 
to determine whether: 

• the program check is within the user-written 
program, 

• or in a user-written module used by the 
program. 

Note: 

If the program check is within an IBM-supplied 

module used by the program, and no system 

dump was executed when the program check 

occurred, re-run the program with the 

// OPTION DUMP statement in the job stream 

(Refer to Section 2-A-2) Otherwise inform IBM 

and have the foHowing information available: 

• SYSLOG output 

• Job stream 

• System dump output 

• Program listing and linkage editor map. 



►| Turn to chart 11, 



Yes 



Yes 




This indicates the program check occurred 
within the POWER/VS partition. 
Turn to chart 13, check 5. 



If a System Dump was executed, you may be 
able to isolate the error by using the informa- 
tion already available to you. If this is the case, 
go to check 13 on part 4 of this chart. 
If a System Dump was not executed, it will be 
necessary to re-run the job and include the 
// OPTION DUMP statement in the job stream 
before going to check 13 on part 4 of this 
chart. Also initiate the SDAID dump on event 
Program Check (refer to Section 2-B-10) and 
if your system supports PDAID, initiate a 
FETCH/LOAD trace to trace the phase being 
loaded in the SVA' (Refer to Section 2-B-4). 



Proceed to check 3 



\, 



Proceed to check 4 . 



turn to chart 12. 



Turn to chart 13, 



Proceed to check 5. 



*lf the program has been link-edited using the 
DOS/VS relocating loader option, the re- 
location factor must be calculated based on 
the start address of the partition used for the 
program when it failed. 
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Program canceled by Program Check 



Check 



Check 5- 

Analyze failing 
instruction and 
type of program 
check 



Method of Analysis 



Can the cause of the failure be isolated using 
the program listing, error messages, and job 
stream? 



Yes 



No 
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Recommendations to Aid 
Further Problem Analysis 



Make correction as necessary and re-run 
the program. 



Proceed to check 6. 



— Check 

Dump of 
partition available? 



Was a system dump executed when the 
program check occurred? (System dump is 
described in Section 2-A-2), 



Yes 



No 



Proceed to check 7, 



Re-run the program with // OPTION DUMP 

statement in the job stream. 

Also, use the SDAID stop-on-event prdgram 

check and obtain a non-destroying dump. 

(Refer to Section 2-B-10.) 

When you have obtained the dumps 

continue problem analysis from check 7 of 

this chart. 



o 



Check 7- 



Analyze dump of 
partition (Level 1) 



Use error messages linkage editor map*, and 
program listing to locate failing instruction in 
the Dump. 
(An example is shown in Section 2-E-3.) 



If the instruction and code appears correct 
and has a valid operation code and data 
field, proceed to check 8. 
If the program check message indicates an 
error in input/output operation in your 
program, go to check 10; otherwise proceec 
to check 8. 



Checks — 

Analyze dump of 
partition (Level 2) 



A. Locate the partition save area and inspect 
the contents of general purpose registers. 
(The location and format of partition save 
areas are described in Chapter 1 1 of this 
Section.) 



B. Use program listing, and linkage editor 
map* to locate data areas in the dump used 
by the failing instruction. 



*lf the program has been I ink -edited using the 
DOS/VS relocating loader option, the relocation 
factor must be calculated based on the start 
address of the partition used for the program 
when it failed. 



Look for unreasonable or totally unexpected 
values in the general purpose registers. If you 
find any that are connected to the failing 
instruction, locate the code in the program 
listing responsible for preparing the register (s), 
(General register usage is described in 
Chapter 9 of this Section.) 
If the cause of the error cannot be isolated, 
proceed to check 9. 



Depending on the type of program check 
indicated by the error message, inspect data 
for validity, duplication, missing information, 
and sequence errors. 

If the cause of the error cannot be isolated, 
proceed to check 9. 
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Method :of A na lysis 



Recommendations to Aid 
Further Problem Analysis 



i4' *"; 



Checks- 



Analyze the general 
register and data 
preparation 
instructions 



Inspect the progranrlogicand instructions 
responsible for preparing the general 
registers and data areas used by the failing 
instruction. 



If an input/output operation is involved, 
proceed to check 10; otherwise, go to check 1 1 . 



Check 10-^ 

Analyze the input/ 
output operation 



Locate and inspect command control blocks 
(CCBs) and channel programs in the system 
dump as described in Chapter 5 in this Section. 
Note: to locate and analyze CCBs and channel 
programs for programs using VSAM 
files, consult the description given in 
Chapter 4 in this Section. 



If it is an input operation, and this input is used 
to prepare the general registers or data fields 
used by the failing instruction, you may suspect 
the program that produced the input. 
Proceed to check 1 1, or first analyze the 
program that provided the input to this program 
by following the recommendations given in 
chart*08 (incorrect output). 



Check n — 

Prepare a program 
re-run to gather more 
detailed system 
information 



Use SDAID SA and/or GA trace functions if 
you suspect that data of general register 
alteration is the cause of the error. Specify 
address limits on the suspected areas 
calculated from the start of the partition in 
which the program is re-run. Refer to Section 
2-B-10.) 
Note: the SA trace can not be used to trace 

areas altered directly by input/ 

output operation. 
If the logic flow of the program during 
execution is in doubt, use the SDAID BR 
trace function on the partition in which the 
program is re-run. 



B. If the program is running in virtual mode or 
using user written channel program 
translation routines, use SDAID stop-on- 
event program check and obtain a non- 
destroying dump. (See note) 

(Refer to Section 2-B-10.) 

C. If the program is running in virtual mode 
and using the IBM-supplied channel pro- 
gram translation routine, check that your 
program is not violating the rules for 
channel program translation support. 



Proceed to check 1 2. 






Check the general rules applicable to channel 
program translation routines, (Refer to 
Chapter 1 3 in this Section.) 



Note: The SDAID non-destroying dump 

enables you to analyze the CCB/CCW 
copy blocks and the CCW/TCB in 
the supervisor area. Note that these 
blocks may be overwritten by the 
system dump when analyzing the 
output from a system dump. 
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Check 12 

Re-analyze the 
output from the 
program re-run 



Use all the information obtained from the re-run 
and re-analyze the problem. If the error cannot 
be isolated, you may either inform IBM or re- 
assemble the program, inserting one or more of 
the following assembly macros or statements 
in your program. Then re-run the program. 



• PRINT GEN (to obtain an expansion of ail 
macros in used by the program). 

• PDUMP (to obtain the dumps of selected 
areas of storage, such as input/output areas, 
during program execution. Refer to Section 
2-A-5) 

• DUMP or JDUMP (to obtain a dump of 
partition and supervisor at a point in the 
program before the program check occurs. 
Refer to Section 2-A-5.) 



If you choose to inform IBM, have the 
following information available: 
i SYS LOG output 

• Job stream 

• SDAUD output 

• Program listing and linl<age editor map. 



Re-analyze the problem using output obtained 
from the re-run. Examine the expansions of 
maaos used by the program and checl< the 
DTP macros used for file definition with the 
program listing. 

If the error can not be isolated, inform IBM 
and have all information obtained from program 
re-runs, plus any notes made of your previous 
analysis. 



Check 13 

Analyze dump 
of theSVA 



A. If it is known which program or phase 
in the SVA caused the program check, 
use error messages and program listing 
to locate the failing instruction in the 
dump. (An example is shown in Section 
2-A-2of this manual). 

B. If the name of the phase in the SVA 
that caused the program check is not 
known, use the PDAID FETCH/LOAD 
trace output to locate the last phase 
used by the program. 

The load address of the phase should be 
the start address of the SVA printed in 
the dump. 



Compare the hex code of the failing 
instruction given in the assembly listing 
with the hex code in the dump output. 
If the instruction and code appears to be 
correct and has valid operation code and 
data fields specified, continue problem 
analysis from check 8 on part 2 of this 
chart. 

If the program check message indicates an 
error in I/O operations, continue problem 
analysis from check 1 on part 3 of this 
chart. 
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Program canceled by Illegal SVC 

SUPPORT FOR CHART 10 



The complete text for message 0S04 1 is: 

ILLEGAL SVC - HEX LOCATION nnnnnn - SVC 
CODE nn 

where nn is in hexadecimal notation. 

This message results from the following causes: 

1. When nn is 02: The phase name given does not start with 
^$B, or 

For LIOCS, macros called in invalid sequence. 



For other conditions, the user specified a temporary exit 
(SVC 8) for a logical transient. In the temporary exit 
routine, another routine is called (by an SVC 2) before 
an SVC 9 is issued to free the transient area. 

2. When nn is 05: The 'to' range specified in the MVCOM 
macro is invalid. 

3. When nn is OA, 1 2, 1 3, or 1 8: The supervisor was 
generated without the timer option. 

4. When nn is OB: The call was not given by a logical 
transient routine. 

5. When nn is 1 6, 1 7, or 1 A: The caller did not have a PSW 
key of zero. This is applicable only in a multiprogramming 
system. 

6. When nn is 23: More than 1 6 holds have been issued for 
the same track. 

7. When nn is 24: Free a non-DASD or a track that is not 
held. 

8. When nn is 26: A subtask issued attach, or the save area 
is not on a doubleward boundary. 

9. When nn is 27: A main task issued detach without 
SAVE = parameter, or 

A main task issued detach, but the ID of the subtask in 
the save area passed is not valid, or 

A main task attempts to detach on already terminating 
subtask. 

10. When nn is 29: A DEQ is issued by a task that did not 
ENQ the resource. (This is valid in an AB routine.) 



1 1 . When nn is 2A: A subtask (without an ECB 
has issued an ENQ nrecro, or 



parameter) 



12. 



A subtask has issued an ENQ macro to a resource that 
has not been dequeued by another task that has been 
terminated, or 

A task has issued two ENQ macros to the same resource 
without an intervening DEQ. 

When nn is 2D: Emulator execution was attempted, but 
the EU parameter of the SUPVR macro was omitted or 
incorrectly specified during system generation. 



13. When nn is 32: For LIOCS: 

a. An imperative macro (such as WRITE or PUT) was 
issued to a module that does not contain the 
requested function, or 

b. A PUT was issued for an ISAM retrieve module 
without a preceding GET, or 

c. An invalid ASA first character for the printer 
was used, or 

d. A wrong length record indication occurred while 
processing 1287 documents when 
RECFORM=UNDEF,or 

e. The 1287 program erroneously contained a CCW(s) 
with the SLI flag bit 'OFF', or 

14. When nn is any other value: The supervisor function 
requested by the operand of the SVC is not defined 
for the supervisor being used. 



\,.._...y 



Causes for Message 0S04I (Cancel Code X'll') 



4.24 Debugging for Programmers, part 1 



Check 



Check 1 



Method of Analysis 



Supervisor support for 
the SVC code printed 
in the error message 



Use the supervisor listing to checl< if the option 
used by the SVC is supported. For example, 
SVC X'43' must be supported by a supervisor 
generated with PFIX = YES. 



Compare the SVC code printed with the list of 
SVCs given in Chapter 6 of this Section. 



Program canceled by Illegal SVC 

CHART 10, PART 1 OF 1 

Recommendations to Aid 
Further Problem Analysis 



If the option is not supported, avoid the use 
of the SVC by the program, or re-assemble 
the supervisor, or re-run the program using 
a supervisor that supports the option. 



If the SVC code printed in the error message is 
not listed, go to check 3. 
Use the figure opposite to isolate possible 
causes of error if the error message is 0S04I. 
If the option is supported and no reason can be 
established for the error, proceed to check 2. 



Check 2 



Lxjcation of SVCs 
issued by the program 



Use the program listing and linkage editor map* 
to locate where the SVC is issued. 
Note: To ensure that all SVCs issued by the 
program are checked, use a program listing 
that shows the expansions of the macros used. 
(If such a listing is not available, you will have 
to re-assemble the program with the 
PRINT GEN assembly control statement.) 



Check the sequence of SVCs issued and macros 
used to ensure that the program is written to 
enable correct use and sequence of SVCs. 
If there is any doubt about the sequence of 
SVCs issued by the program, re-run the 
program with the PDAID GSVC trace. (Refer 
to Section 2-B-4.) If the error can not be 
isolated, proceed to cheek 3. 



o 



Check 3 — 

Dump of partition 



Was a System dump taken when the program 

check occurred? 

(System dump is described in Section 2-A-2.) 



No 



Re-run the program with the // OPTION DUMP 
statement in the job stream, or initiate the 
SDAID dump on event program check (refer 
to Section 2, B-10-F). 



Yes 



Proceed to check 4. 



Check 4 



Analyze the dump 



Use the program listing, error message, lin-kage 
editor map*, and system dump to lobate the 
SVC instruction in the dump. 



If the program has been link edited using 
the DOS/VS relocating loader option, the 
-relocation factor must be calculated based on 
the start address of the partition used for 
the program when it failed. 



Compare the hexadecimal code for the SVC in 

the dump with the SVC instruction in the 

program listing. 

If there are differences, analyze the program 

to isolate the point where the correct SVC 

instruction is overwritten. 

As a further aid in this analysis, you may need 

to re-run the program with the SD A! D SA 

trace. Use the STOP ON EVENT option and 

obtain a non-destroying dump at the point 

suspected of causing the overwriting. 

If there are no differences and the error can not 

be isolated, inform IBM and have the following 

ingormation available: 

• Supervisor listing 

• Program listing, including the macro 
expansions 

• Linkage editor map 

• System dump 

• SYSLOG output 

• Job stream. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 






Ch«ck 1 



Reason for program 
cancelation 



Did the operator cancel the program? 



Yes 



Inspect messages printed on SYSLOG and 
SYSLST prior to the cancelation. If necessary, 
interview the operator to establish system 
activity during program execution. (It is possible 
that incorrect response to messages issued during 
program execution caused an unusual condition 
to occur.) 
Proceed to check 2. 



No 



Examine the program listing and check for 

the use of DUMP or CANCEL macros left in 

the program from testing phases (program 

testing). 

Remove these macros and proceed to check 2. 



Check 2 



Re-run the program 



Re-run the program. If possible, be present 
during the re-run to observe system activity. 
Follow the recommendations given in DOS/VS 
Messages manual, and ensure the correct 
response is given to messages issued during 
program execution. 

Ensure the use of the //OPTION DUMP state- 
ment in the job stream, to obtain a system dump 
when the program is canceled. (Refer to 
Section 2-A-2.) 



If the identical error recurs, it may be due to 

the incorrect use by the program of an IBM- 

supplied routine. 

Inform IBM and have the following information 

available: 

• SYSLOG output 

• SYSLST output 

• System dump output 

• Job stream 

• Program listing and linkage editor map. 



> 
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I I 



Check 



Method of Analysis 



Program canceled by Program Check in Supervisor 
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Recommendations to Aid 
Further Problem Analysis 



Check 1 



Approximate the area 
where the program 
check occurred 



Is the program check within the logical 
transient area? (Message 0S08I followed by 
message 0S1 1 1 will inform you where the 
instruction address, (the program check 
occurred) is located. 




Go to check 8. 



^ 



Proceed to check 2. 



Check 2 



Dump available? 



Was a system dump executed at the 
occurrence of the program check? 
(Refer to Section 2-A-2.) 



No 



Yes 



o 



Check 3 



Analyze the system 
dump to determine the 
name of the logical 
transient 



Use the system dump to locate the partition 
save area. (Refer to Chapter 12 in this Section.) 
Locate the return PSW in the save area and 
determine the failing instruction address. 
Locate this address in the dump and go two 
bytes to the left. 

Is the contents of these two bytes X'0A02' 
(SVC 2)? 



Re-run the program with the // OPTION DUMP 
statement in the job stream. Also, initiate the 
PDAID transient dump program, described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
After the re-run, go to check 4. 



Proceed to check 3. 



Re-run the program and initiate the PDAID 
transient dump program as described in 
Section 2-A-4, or use the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump. (Refer to Section 2-B-10.) 
(Also include the //OPTION DUMP statement 
in the job stream to obtain a system dump.) 
Proceed to check 4. 



Locate the general purpose register 1 in the 
save area. This consists an address. 
Locate this address in the dump and convert 
the first 8 bytes, starting from this address, to 
characters. This is normally the name of the 
logical transient fetched by the program. 
(For OPEN or CLOSE register 1 may point 
to the DFT). 

Note: The cause of the program check need not 
necessarily be in this transient, since a logical 
transient may need to fetch another transient 
to complete a service. The program check 
could therefore be caused by incorrect para- 
meters being passed to the transient. 
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Check 



Method of Analysis 



Recomrnendations to Aid 
Further Problem Analysis 



Check 4 



Determine the 
name of the logical 
transient fetched 



Use the PDAID transient dump output to 
determine the name by converting the first 
8 bytes of the dump to characters. (Refer to 
the example of a transient dump output given 
in Section 2-A-4.) 



Use the SDAID non-destroying dump output to 
locate Byte X'1 C of SYSCOM which contains 
the address of the logical transient area. 
(The address of SYSCOM is contained in 
bytes X'80-83' of the low address storage. 
(Refer to Section 2-E-2.) 
The first 8 bytes of the LTA, when converted 
to characters, give the name of the logical 
transient fetched. 



Proceed to check 5. 



-Check 5 



No 



Type of logical 
transient program 



Is the logical transient user-written? 



Use the problem program listing and the system 
to determine the routine that was being 
executed when the program check occurred. 
Then determine which macro in the routine 
was responsible for fetching the logical 
transient. For example, the OPEN macro will 
cause the logical transient $$BOPEN to be 
fetched. 

If the error can not be isolated, inform IBM and 
have the following information available: 

• SYSLOG output 

• PDAID/SDAID output (if available) 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



^kj 



Yes 



Proceed to check 6. 



Check 6 



PDAID or SDAID out- 
put available? 



To complete problem analysis you will require 
the PDAID transient dump output, or a non- 
destroying dump output from the SDAID 
program. 



If you have already re-run the program and 
obtained one or both of these dumps, proceed 
to check 7. Otherwise, re-run the program, 
following the recommendations given in check 2 
before proceeding to check 7. 
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Check 7 



Check 7 



Analyze the dump of 
the logical transient 
area 



Method of Analysis 



Program canceled by Program Check in Supervisor 
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Recommendations to Aid 
Further Problem Analysis 



Use the PDAID/SDAID output and the 
assembly listing of the logical transient fetched 
to locate the failing instruction address in the 
logical transient area. 



A. Locate the general registers at the top of 
the dump. 



J 



Locate data preparation areas that are used 
by the failing instruction in the dump. 
Check the instructions in the assembly 
listing of the Logical Transient that is 
responsible for preparing data areas for use 
by the failing instruction. 



\ 



Look for unreasonable or totally unexpected 
values in the registers. If you find any that are 
connected with the failing instructions locate 
the code in the assembly listing that is 
responsible for preparing the register (s) 
If the contents of the general registers 
appear to be correct proceed to check 8. 
(General Register usage is described in 
Chapter 9 of this Section). 



Depending on the error message, inspect data 
used by the failing instruction for validity, 
duplication, and missing information. 

If the error cannnot be isolated, inform IBM 
and have the following information available: 

• SYSLOG output 

• PDAID/SDAID output 

• Job stream 

• Supervisor listing 

• Program and transient assembly listings 

• Linkage editor maps. 



Check 8 



Isolate area in the 
supervisor causing 
the program check 



Use the error message and assembly listing of 
the supervisor to determine in which routine 
in the supervisor the program check occurs. 



Before informing IBM of the problem, re-run 
the program with the SDAID stop-on-event 
program check function and obtain a non- 
destroying dump when the program check 
occurs. (Refer to Section 2-B-10,) 
Have the following information available. 

• SYSLOG output 

• Job stream 

• SDAID output 

• Supervisor listing 

• Program listing and linkage editor map. 
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Check 



Method of Analysis 



Recommendations to Aid 
Further Problem Analysis 






Check 1 - 

Eliminate 
components 
(Level 1) 



Rerun the job under DOS/VS, that is do 
not run as a POWER/VS job and do not 
initiate a POWER/VS partition. Ensure 
to include the // OPTION DUMP state- 
ment in the job stream and as an option 
initiate the SDAID dump on program 
check. (For jobs entered under RJE you 
must submit the job stream and input 
data files to the central station, request 
output to be directed to a local LST 
and/or PUN.) 



If the malfunction recurs, analyze it 
using the dumps obtained as indicated 
in this section commencing at Chart 01. 

If the malfunction does not recur 
proceed to check 2. 



. Check 2 

Programs fail 
when run under 
POWER/VS only 



Has the program ever run correctly 
under POWER/VS? 



\ 



No 



Check the following. 

• Errors in JECL and device assignments. 

• Condition of spooling devices and disk 
packs. 

• The level of, and support for 
POWER/VS in the DOS/VS supervisor. 

• Storage requirements and options 
specified in your version of 
POWER/VS. 

Try to correct any obvious errors. 



Yes 



Check the following: 

• Changes in job stream JECL 

• Changes in the DOS/VS supervisor 

• Changes to data files/volumes 

• Changes to POWER/VS (regeneration 
or application of PTFs) 

• Condition of spooling devices and 
disk packs. 






Determine if other programs are 
failing when run under the same 
version of POWER/VS. If so, contact 
the programmers concerned - they 
may have isolated the reason already. 
Proceed to check 3. 



Checks 

Wait State 



Was the type of malfunction 
a wait state? 



Yes 



No 



Proceed to check 4 and rerun the job 
as advised in that check but 
immediately the wait state occurs 
execute a standalone dump exactly 
as described in Section 2, A-3-F. 
Then go to check 5. 



Proceed to check 4. 
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Check 



Method of Analyses 




o 



— Check 5 

POWER/VS SCP 
error 



Check 6 

RJE line or 
processing 
in error 



© 



Was the (ailing job entered or output via 
terminal under POWER/VS RJE? 



Yes 



No 




You may suspect the POWER/VS SCP 
of causing the error. Inform the IBM 
CE/SE and have the following 
information available: 

• SYSLOG log sheet 

• System dump) 

• SDAIDdumpJ* 

• Input job stream 

• Line printer (LST) output 

• Standalone dump ,\ 
and note of low f 
address storage, I 
plus PDS dump ) 

• PDISPLAY command output 

• Notes on your analysis 

• POWER/VS SCP assembly listing 
and linkage editor map 



You may suspect the RJE line used 
for job input or the processing of 
RJE under POWER/VS. 



* if applicable to the type of 
malfunction. 

»* contained on SYSLOG 



Recommendation to Aid 
Further Problem Analyses 



Submit )ob stream and data to the central 
station to be entered via local units. Request 
output to a local LST and/or PUN. It is 
advisable for you to supervise program 
execution at the central station to note 
system activity and avoid interruptions 
during job execution. Ensure the 
// OPTION DUMP statement is included 
in the job stream and request the control 
station to initiate SDAID dump on program 
check. After the input is spooled issue the 
PDISPLAY ALL command to obtain the 
status of ALL queues. Issue this command 
again just before the output (LST or PUN) 
tasks are started. 

In case of incorrect output the queue 
records and their associated data records 
belonging to a specified job name can be 
dumped. (See appendix L, POWER/VS 
File Dump Program.) 

• If the malfunction recurs, proceed 
to check 5. 

• If the malfunction does not recur 
inspect the RJE line used by the RDR 
input for the job stream or RJE pro- 
cessing within the POWER/VS SCP. 

Go to check 6. 



If the error cannot be isolated by the pre- 
vious general checks, rerun the job under 
POWER/VS with the SDAID dump on pro- 
gram check initiated. Also ensure that the 
// OPTION DUMP statement is included in the 
job stream. After the input has been 
spooled issue the PDISPLAY ALL command 
to obtain the status of all queues. Issue this 
command again just before the output 
(LST or PUN) tasks are started. 
In case of incorrect output the queue 
records and their associated data records 
belonging to a specified job name can be 
dumped. (See appendix L, POWER/VS 
File Dump Program.) 

• If the malfunction does not I'eeur, no 
check 5. 

• If the malfufunction does not recur, no 
further analysis as to be cause of the 
original failure can be done. However, 
inform IBM and keep a record of the 
problem and its solution. 



To verify the line, re-run the job using the 
RJE I/O trace. (See appendix L) 

• Inform IBM and have following 
information available: 

• SYSLOG log sheet 

• Sysjtem dump > 

• SDAID dump f 

• Input job stream 

• Line printer (LST) output 

• Standalone dump, \ 
and note of low f 
address storage, ( 
plus PDS dump ) 

• PDISPLAY command output) 

• PINQUIRE command output) 

• RJE I/O trace outputdn dump) 

• Notes on your analysis 
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The figure below illustrates the general organization of virtual storage. 

The supervisor is loaded in the real address area beginning at virtual address byte 0. 
Virtual storage can extend up to 16 million bytes. The figure also shows the general 
organization of the supervisor. Each area within the supervisor is described in more 
detail in this Section, except for the low address area and the PD area which are 
described in Section 2. 



GENERAL ORGANIZATION 
OF VIRTUAL STORAGE 



o 



1 


\ 


Supervisor 




BG-R 




F4-R 


Rea 


F3-R 


Address 


F2-R 




r 


F1-R 


1 


Main Page Pool 
(for programs 
executing in 
virtual mode) 


1 


i 


BG-V 

(Minimum always 
64K) 




F4-V 


Virtual 

Address 

Area 


F3-V 






F2-V 




F1-V 


1 


Shared Virtual Area 
(not applicable to a 
single partition system) 



Partitions 

(See note) 
Background 

Foreground 4 

Foreground 3 

Foreground 2 

Foreground 1 



Low address storage 



For details, 

see Section 2-E-2. 



CPU model-dependent logout area 



Background communication region 



System communication region 



Save areas 

Option tables 

I/O tables and information blocks 



F1 Foreground communication 

F2 regions (One for each 

F3 partition specified during 

F4 system generation) 



Logical transient area (LTA) 



Physical transient area (PTA) 



PD area (optional) For details, 

see Section 2-B-3 



CCW translation routines 



Page management routines 



VSAM routines 



Machine check handler, 
Channel check handler. 



RAS transient area (RTA) 



Page management tables, 
CCW translation copy blocks 



Supervisor organization 



Note: The organization of a five partition system (one background and 
four foreground partitions) is shown. Each partition consists of 
the pair "real partition - virtual partition". 

The SVA and each virtual or real partition must be a multiple of2K. It may also, 
however, be OK, except the SVA andBG virtual which must be at least 64K. 
To be active a foreground partition must have a virtual partition of at least 64K. 



Figure 4.1 The organization of Virtual Storage. 

The organization of the supervisor area is also illustrated and parts of it are described in 
this Section. 
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COMMUNICATION 
REGIONS 



Partition Communication Regions, (Comregs) 

In a multiprogramming system individual communication regions are defined for 
each partition. The communication region (comreg) belonging to the active 
partition is an area that serves as an initial pointer to other supervisor tables and 
areas. The comreg also contains pointers to user program tables and areas. The 
MVCOM and COM RG macro instructions enable access to information contained in 
these regions. Fields in the comreg are addressed relative to the first byte. The com- 
munication regions are located within the supervisor and their format is described 
in Figure 4.2 and Figure 4.3, parts 1 through 6, explain the contents of each field. 






Example A 



Locating the partition communication regions 

After IPL, low address storage bytes X'14— 17' contain the address of the comreg 
used by the active partition. 

Note: The contents of these bytes will not be valid after executing the stand-alone 
dump program. Therefore, it is important for the operator to dump, or display 
and note, the contents of low address storage before executing the stand-alone 
dump. Locate bytes X'7C' and '7D'in the active comreg. This is the address of 
PIB2, also referred to as the PIB (program Information Block) Extension. The first 
two bytes of an entry in the PIB2 contain the address of its associated comreg. 
(Refer to Chapter 7 in this Section for a detailed description of the PIB2. ) 

Example A below shows a dump of low address storage. Bytes X'14— 17' contain 
the address 04A0. This address has then been located in a stand-alone dump output 
as shown in example B. The address of PIB2 is indicated in this example. 
Example C shows the PIB2 from which the addresses of all the partition comregs 
are found. 



'X.J 



..D«.,..QjQ0!Oiaft ^,,4grr7%<W$«»...t^< 



00000000 00000000 00000000 00000000 00000000 0OO0(O4i 



40000000 00000000 



..47QD.QO0.0 00.0.40,C3C. 440.C.000.a OOOOISAA. .-OOOOOOOO 00000000 470FS,000 f^fxfoHfi 



Example B 



07B7E0 E2C9C4C5 



000000 
000020 
000040 
000060 
000080 
OOOOAO 

0000 

O0<HA(! 

ooo!C 

0004E0 
000500 



)900A619 
47000000 
0007B038 
[44000000 
00000540 
00000000 
00000000 
F1F261F0 
00060FFF 
^1044296 
46390000 



•/m 



40626306 D9C1C7C5 40E4D5C3 CBCIDSC? C5C4C3C8 C1D5C7C5 C4404004 r-/— / ^ J / j >#— /- 

/)(:z 000 |00000000 [4B4B4B4B 4B4B4B4B «. .,£./,,./, 

"^^ 000 00000000 470F2000 0000090C 

900 01AAAB17 00080000 0000A67E C 

UUULUOOO 0007B3AA 00080000 O000A67E 

10043010 00010000 00000000 OOOOOIEO ' ^ j^ , / 

00000000 00000100 60000bOC 00000000 fS^^ X 7C — " 

00000000 OOOOOOOO D5D640D5 C1D4C540,,..-— ^ ^ 7"^ NO NAME 

OOOBFFFF FD7FCE03 1000CE50 002E4q^O Jlj(/tt>M oK P/OO •■• 

F2F0F6F7 F3F3F4F0 00003CD4 OfiflOfOSC V^ /7«!»'^s»" yrfOK. 673340. 

00008090 00007118 00003e64 C3BDjifc A30 ^ ^**fC)tft Hr) 



vvwuvoCu UUULUUUU uuuuADru 



OOOOOOOO 
OOOOOOOO 
— SAME— 
F661F7F3 
00043067 
42974389 
3DCC3E4C 



00020007 
20000060 

70007000 
OOOOOOOO 
3F003F06 
3EBC0010 



00040005 
000002CO 

OOOOOOOO 
00000010 
3F0C38F1 
OOOOOOOO 



Example C 



003 B60 
003B80 



27000000 40000001 03003P' 



..//BOUNF .. 



SSI^aS ficlc^</Sg.c.^ 3BD4 fi'^^^ A'^. J^^.^^^^^^ 

""'°'-'' innnnrViif • "S^otifu »»-nmf— ^""•■" tflo^AridArtn/nooynnoB oooooooo| ^ 

003BE0 b00OQO0o' t)4AQb o00 00020007 OOOOOOOO OOIO00POlS59OT056 OOOOOOOO OOOOOOOO I > PlB2 • * 

O03CO0 020000Qj»4?gD()62 OObOOObd 00000000 " OOJOOOOO gg^OBE OOOOOCOO OOOOOOOO I ) ••••« 

003C20. 80*400000 teSBOOOBA ^^^^ S^^2mm\%r~ OOSOOOOgiOOy"""" """""""" nunnnnm. , S.... .......... 

■' </F3^ t6 i^/'^ez ^ .^i^n-^^>^/ A^/^^c^rz<.^»^ ::::.... ,« » 



/ J200C2C7 80040000 Q00064S8' C00E28BO 8000C6F4 80007000 00006518 



(Cxfi/tm 



4.34 Debugging for Programmers, part 2 



Page of GC33-5380-3, Revised November 28, 1977, By TNL GN33-9232 



FnCOMREG 



Displacement' 
hexadecimal 

decimal 



Displacement 
hexadecimal 

decimal 



Displacement 
hexadecimal 

decimal 






Displacement 
hexadecimal 

decimal 



Displacement 
hexadecimal 

decimal 



Displacement 
hexadecimal 

decimal 
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8 


OA 


00 


17 
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24 


28 


2C 





8 
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12 


23 


24 


32 


36 


40 
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Area 


Date 


Address of 


Address 


Problem 


JPSI 


Job Name 


Address 
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Byte of Phase 


Length 




PPBEG 


of EOSSP 


Program use 


3yte 




of the 
Partition 


Loaded 


with Highest 
Ending Address 




xxxxxxxx 


XX 


XX 


XXXXXXXXXXX 


X 


xxxxxxxx 


xxxx 


xxxx 


xxxx 


XX 



2E 


30 


34 


35 


36 


37 


38 


39 


3A 


3B 


3C 


3E 


46 


48 


52 


53 


54 


55 


56 


57 


58 


59 


60 


62 


PIK 


End of 


Machine 


System 


Standard 


Dump 


Job 


Linkage 


Language 


Job 


Disk 


Address 




Virtual 


Confg. 


Confg. 


Language 


Log 


Control 


Control 


Translator 


Duration 


Address of 


of 




Storage 


Byte 


Byte 


Translator 


RELLDR 


Byte 


Byte 


Control 


Indicator 


Label 


FOCL 




Address 






I/O 
Options 


and ASCII 
Options 






Byte 


Byte 


Cylinder 




XX 


xxxx 


X 


X 


X 


X 


X 


X 


X 


X 


XX 


XX 



v 

Job Control Switches 



40 


42 


44 


46 


48 


4A 


40 


4E 


4F 


58 


5A 


50 


64 


66 


68 


70 


72 


74 


76 


78 


79 


88 


90 


92 


Address 


Address 


Address 


Address 


Address 


Address 


i Address 


Line 




LIOCS 


Address of 


ID Number 


of 


of 


of 


of 


of 


of 


of 


Count 


System 
date 


Comm. 


PIB Table 


of Last 


PUBTAB 


FAVP 


JIBTAB 


TEBTAB 


FICL 


NICL 


LUBTAB 


for 


Bytes 




Checkpoint 
















SYSLIS1 
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Procedure 


for 


Statement 


SYSIN 


Partition 


Flag 


Options 


Options 


uration 


Name 


Catalog 
Procedure 


Name 


indica- 
tor 


Control 
Block 


Bytes 


X 


X 


X 


xxxxxxxx 


X 


xxxxxxx 


X 


xxxx 


XX 



Figure 4,2 Format and contents of any partition communications region 

*The address of the communications region is in fixed location X'14'— X'17' 
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PARTITION COMMUNICATION REGION 



Displacement 



(Dec) (Hex) 



8 
10 

12 

23 
24 

32 



36 
40 



44 
46 



48 
52 



00 



08 
OA 

OC 

i7 
18 

20 



24 
28 



2C 
2E 



30 
34 



Meaning 



MM/DD/YY or DD/MM/YY either set permanently at IPL time or temporary by the 

job control date statement, or updated every time a GETIME macro is issued when 

time-of-day support is provided. 

Format controlled by BGCOMBEGH-53 

(System Configuration Byte, data convention bit 0) 

Address of the problem program area. (PPBEG) Only 16 lower order bits. 

Address of the beginning of the problem program area. Only 16 lower order bits. 
Y (EOSSP) equals Y (PPBEG) 

User area. If seek separation option is specified, bytes 12 and 13 are used at IPL 
time for the address of the seek address block. 

Use program switch indicator. (UPSI byte) 

Job name set by the job control program from information found in the job 
statement. 

Address of the uppermost byte available to the problem program, that is either the 
address of the uppermost byte of the partition as determined during processing of 
the ALLOC or ALLOCR macro or statement, or the end address of the area 
specified by the SIZE parameter in the EXEC statement. 

Address of the uppermost byte of the last phase of the problem 
program fetched or loaded. Not filled in when the phase in the SVA. 

Highest ending main-storage address of the last phase among all the phases having the 
same first four characters as the operand on the EXEC statement. For the phase 
$LNKEDT this field is not filled in. The address value may be incorrect if the 
program loads any of these phases above or below its link-edited origin address. If the 
EXEC statement has not operand, job control places in this location the highest 
ending address of all programs just link-edited. 

Length of the problem program label area. 

The low order byte identifies the. partition (see Appendix B), and equals the 
displacement from the start of the PIB to the start of the PIB of the partition 
(without AP). The PIK from BGCOMREG changes during system operation and 
contains the PIK of the active partition (whichever one is active). The PIK in the 
FnCOMREG remains unchanged. 

End address of virtual storage. 

Machine Configuration Byte (Values set at supervisor generation time) 

Bit 0: Always set to indicate standard storage protect 
1: 1=Decimal feature (always set) 
2: 1=Floating point feature 

0=No floating point feature 
3: Always set to indicate Physical transient overlap 
4: Always set to indicate standard timer feature 
5: 1=Channel switching device 

0=No channel switching device 
6: 1=Burst mode on multiplex channel support 

.0=No burst mode on multiplex channel support 
7: Indicates MCH/CCH in system. 



J 






\'^' 



Figure 4.3 Key to Communication Region displacement, part 1 of 6 
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PARTITION COMMUNICATION REGION ( Cont'd) 
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o 



Displacement 




lUlaoninn 


(Dec) 


(Hex) 


■•"~ » 


53 


35 


System Configuration byte 

BitO: 1=DDMMYY ,„ . ^. ■ • ^ o-rr^ .r.» 
« .../.rsr^ww (Date convention bit set at generation time by STDJC) 
U-MMUDYY 

1 : 1=Two or more partitions 

O=0ne partition only supported 
2: 1=DASD file-protect supported 

0=No file-protect support for DASD 
3: 1=DASD SYSIN-SYSFIL 

0=No DASD SYSIN-SYSFIL 
4: 1 =Teleprocessing 

0=No teleprocessing 
5: 1=Two or more partitions 

O=0ne partition only supported 
6: 1=Asynchronous processing 

0=No asynchronous processing 
7: 1=Track Hold 

0=No Track Hold. 


54 


36 


This byte contains the standard language translator I/O options (set by STDJC macro). 

BitO: DECK option 1= yes, output object modules on SYSPCH 

1: LIST option 1= yes, output source module listings and diagnostics 

on SYSLST 
2: LIST X option 1= yes, output hexadecimal object module listings on 

SYSLST (compilers only) 
3: SYM option 1= yes, output symbol tables on SYSLST/SYSPCH 
4: XREF option 1= yes, output symbolic cross-reference list on SYSLST 
5: ERRS option 1= yes, output diagnostics on SYSLST (compilers only) 
6: CHARSET option 1= 48, input on SYSIPT is 48 or 60 character set 
7: Reserved. 


55 


37 


This byte contains the standard supervisor options for abnormal EOJ, Relocating 
Loader and Control statement display and the indicator for the presence of the 
ASCII-EBCDIC and EBCDIC-ASCII translation tables. 






BitO 


Always on 






1 


DUMP option 1= yes, dump registers and storage on SYSLST 






2 


1 =partition in wait state, because volume is to be mounted 






3 


LOG option 1= yes, list all control statements on SYSLST 






4 


1 =dummy device search in progress; do not enter ERP 






5 


Not used 






6 


Relocating Load 






option 1= yes. Relocating Loader supported 






7: ASH option 1= yes, ASCII supported. 


56 


38 


Job Control byte 

Bit 0: 1= Job accounting Interface (JA) is not supported 
0= Job accounting Interface (J A) is supported 

1:1= Return to caller on LIOCS disk open failure 

0= Do not return to caller on LIOCS disk open failure 

2: 1= Job control input from SYSRDR 
0= Job control input from SYSLOG 



Figure 4.3 Key to Communication Region displacement, part 2 of 6 
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PARTITION COMMUNICATION REGION 
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56 



57 



58 



59 



38 



39 



3A 



3B 



c 



Job Control byte (. . . . Cont'd) 

Bit 3: 1= Job control output on SYSLOG 

0= Job control output not on SYSLOG 
4: 1= Cancel job 

0= Do not cancel job 
5: 1= Pause at end-of-job step 

0= No pause at end-of-job step 
6: 1= SYSLOG is not a console printer-keyboard or DOC 

0= SYSLOG is a console printer-keyboard or DOC 
7: 1= SYSLOG is assigned to the same device as SYSLST 
0= SYSLOG is not assigned to the same device as SYSLST. 

Linkage control byte 

Bit 0-. 1=SYSLNK open for output 

0= SYSLNK not open for output 
1 : 1= Update of Second Level Directory and RAS loadlist in progress. 

(Interface between |MAINDIR and supervisor). 
2: 1= Allow EXEC 

0= Suppress EXEC 
3: 1 = Catalog linkage editor output 

0= Do not catalog linkage editor output 
4: 1= Supervisor has been updated 

0= Supervisor has not been updated 
5: 1=PCIL OPEN in progress 
6: 1= Update of system CIL in progress 

(Interface between |MAINDIR and supervisor). 
7: 1 = Check automatic condense limits and EOJ. 

(Interface between librarian and job control). 

Language processor control byte. This is a set of switches used to specify non-standard 
language translator options. The switches within the byte are controlled by job 
control OPTION statements and when set to 1 , override standard options. The 
format of this byte is identical to the standard option byte (displacement 54) with 
one exception: Bit 7 in this byte is used to indicate to LIOCS that the rewind and 
unload option has been specified. 

Job duration indicator byte 

Bit 0: 1= Job in progress 

0= Job not in progress 
1:1= Dump or partition dump on an abnormal end-of-job condition (see byte 141) 

0= No dump on abnormal EOJ 
2: 1= Pause at EOJ step 

0= No pause at EOJ 
3: 1= Job control output on SYSLST 

0= Output not on SYSLST 
4: 1= Job is being run out of sequence with a temporary assignment for SYSRDR 

0= Conditions for 1 -setting not met 
5: 1= PCI L is being condensed 

0= PCIL is not being condensed 
6: 1= //DATE statement processed for current job 

0= No //DATE statement processed for current job 
7: 1= Batch command just issued 

0= Condition for 1 -setting did not occur. 



/f''A 
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Meaning 


(Dec) 


(Hex) 


60 


3C 


Binary disk address of the volume label area (label cylinder). 


62 


3E 


) Addresses of FOCL, PUB, FAVP, JIB, TEB, FICL, NICL and LUB 


76 


4C 


1 (See Figure 4.2) 


78 


4E 


Set to the value nn specified in the LINES=: nn parameter of the STDJC macro. 


79 


4F 


The format of the system date contained within this field is determined by the IPL 
program from information supplied in the date convention bit (displacement 53). 
Bytes 85-87 contain the day count. 


88 


58 


Bytes reserved for use by LIOCS. Transient dump programs insert a key to indicate 
to the LIOCS end-of-volume routine, $$BCMT07, that it was called by a B-transient 


90 


5A 


Address of the first part of the program information block (PIB) table. 


92 


5C 


ID number of the last checkpoint. Byte 92 is also the temporary indicator of file 
protected DASD. Bits 0-6 correspond to channels 0-6. A bit ON means DASDFP 
for that channel. Bit 7 indicates 2321 DASDFP support. Byte 93 is used at IPL 
time by PIOCS - Bit 0: 1 = 3330 file protection 

Bit 1: 1 = 3340 file protection 

Bit 2:1 = 3350 file protection 


94 


5E 


Job zone for Time of Day. If ZONE=EAST, value is positive; if ZONE=WEST, 
value is negative. 


96 


60 


Address of the disk information block (DIB) table for the partition. 


98 


62 


Device flags 

Bit 0: 1 = At least one DTF in the partition is open with the 3800 extended buffering 
option. 


100 


64 


Address for PC, IT, and OC option tables. 


104 


68 




106 


6A 


Key of the program that has interval timer support. They key is the same as the 
PIK for the timer supported partition. If multiple partitions all have timer support 
it is initially X'OOIO'but may be changed to the PIK of another partition by the 
TIMER command. It is copied into all partition communications regions. If no 
partition has interval timer support, these bytes contain X'OOOO'. 


108 


6C 


Reserved 


110 


6E 


Logical Transient Key (LTK) contains the same value as the PIK (PID) (Displace- 
ment 46) when the logical transient is requested. When the transient area is not in 
use, LTK is equal to zero. The SVC2 routine sets the LTK. (See Appendix B 
for a description of the LTK). 
The SVC11 routine resets the LTK, (only significant in BG communication reg.) 


112 


70 


Address of SYSPARM field. 


116 


74 


Address of Job Accounting partition table. 


120 


78 


Address of the Time of Day Clock common area. 


124 


7C 


Address of second part of program information block (PIB) table. 


126 


7E 


Address of PDTABB, table of DTF addresses for MICR support. 


128 


80 


Address of QTAM vector table (IJQTTAD). 


132 


84 


Address of background communications region. 
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134 


86 


Option Indicator byte 

Bit 0: Reserved 

1: 1= EU interface active 

0= EU interface inactive 
2: 1= "I eleprocessing request 

0= No teleprocessing request 
3: 1= Supervisor support for tape 

0= Supervisor does not support tape 
4: Reserved 
5: 1= RETAIN support generated 

0= RETAIN support not generated 
6: 1=Linkage to Channel End Appendage Routine allowed 

0=^ Linkage to Channel End Appendage Routine not allowed 
7: 1= GETVIS function has been initiated 

0= GETVIS function has not been initiated. 


135 


87 


System Configuration byte 2 and RMSR Open Flag byte 

Bit 0: 1=PCIL supported 

0=PCIL not supported 
1: TOD supported 
2: 1=:PFIX macro supported 

0=PFIX macro not supported 
3: 1=Fetch $$OPEN by $JOBCTLJ ) 
4: 1=Fetch $$OPEN by SJOBCTLD [ RMSR OPEN flags 
5: 1=Fetch $$OPEN by $JOBCTLJ for WTM ) 
6: 1=QTAM supported 

0=QTAM not supported 
7: 1=RPS supported 0=R PS not supported 


136 


88 


Pointer to Option table in SYSCOM. Reserved for compatibility reasons. 


140 


8C 


Standard Job Control Option byte 






BitO 


1=EDECK Standard Option 






1 


1=ALIGN Standard Option 






2 


1=PARTDUMP Standard Option 






3 


1=RLD Standard Option 






4-6 


Not used 






7 


1=ACANCEL standard 


141 


8D 


Temporary Job Control Option byte 






BitO 


1=EDECK Temporary Option 






1 


1=ALIGN Temporary Option 






2 


1=PARTDUMP Temporary Option 






3 


1=RLD Temporary Option 






4-5 


Not used 






6 


1=SUBLIB=DF Temporary Option 






7 


1=ACANCEL Temporary Option 


142 


8E 


Disk Configuration byte 

Bit 0-3: Not used 

4: 1 = 3350 supported 

= 3350 not supported 
5: 1 = 3340 supported 

= 3340 not supported 
6: 1 = 3330 supported 

= 3330 not supported 
7: 1 = 231 1 and 231 4/231 9 supported 

= 231 1 and 2314/231 9 not supported 


143 


8F 


Catalogued Procedure Name 



1\ 

J 



\ 
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151 


97 


Interface byte for Catalogued Procedures 








BItO 
1 
2 
3 
4 
5 
6 
7 


1 =Procedure being executed 
1 =Over write processing 
1=::Procedure with data 
1 =Overwrite request for Job Control 
1=lnsert request for Job Control 
1=Procedure end 
1=SYSLOG procedure 
1=:0verwrite request for Supervisor 




152 


98 


JCL statement name for Catalogued Procedure. 




159 


9F 


SYSIN 81 bytes indicator 

Bit 0: 1 ^Permanent 81 bytes on SYSRDR 
1 : 1 ^Permanent 81 bytes on SYSIPT 
2: 1=Temporary 81 bytes on SYSRDR 
3: 1 =TemporarY 81 bytes on SYSIPT 
4-6: Not used 

7: 1=Allow /& for MAINT CATALS. 




160 
164 


■ 
AO 

A4 


Address of POWER/VS partition control block (if none exists for the partition 
this field contains binary 0) 
POWER/VS flag byte 1 






Bit 0: 1 =POWER/VS accounting supported 
1 : 1 =Partition under control of POWER/VS 
2: 1=P0WER/VS partition 
3-7: Not used 




165 


A5 


POWER/VS flag byte 2 
Bit 0-7: Not used 
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System communication Region (SYSCOM) 

This table is located in the supervisor, iiiiiiiediately after the background partition 
communication region. It contains partition-independent pointers and addresses of 
tables used by the system control program (SCP). The contents of SYSCOM is 
listed in Figure 4.4 parts 1 and 2, displacements are given in hexadecimal from the 
first byte of SYSCOM 



Locating SYSCOM 

BytcsX'80 83' of low address storage contain the address of SYSCOM. 

Displacenieni 

Hex 
Dec 



Hex 
Dec 



Hex 
Dec 



Hex 
Dec 



00 


04 


08 


OA 


oc 


10 


14 


18 


00 


04 


08 


10 


12 


16 


20 


24 


Address 


Address 


Address 


Address 


Address 


Address 


Address 


Address 


of Error 


of 


of 


of 


of 


of 


of I/O 


of External 


Block 


Atten 


Operator 


Operator 


SYSRES 


Fetch 


Interrupt 


Interrupt 




tion 


Option 


Request 


PUB 


Routine 


Routine 


Routine 




Exit 


Cancel 
Exit 


Cancel 
Exit 











1C 


20 


24 


25 


28 


2A 


2C 


2E 


2F 


28 


32 


36 


37 


40 


42 


44 


46 


47 


Address 


Address 


Free List 


Address 


Number 


Length 


Number 


Flags 


Flag 


of 


of First 


Pointer 


of 


of 


of One 


of 


and 


Byte 


Logical 


Byte of 




Channel 


Channel 


Error 


Partitions 


Switches 


(see 


Transient 


Problem 




Queue 


Queue 


Queue 






expansion) 


Area 


Progrann 
Area 






Entries 


Entry 









Hex 


30 


34 


35 


38 


3C 


40 


44 


46 


48 


Dec 


48 


52 


53 


56 


60 


64 


68 


70 


72 




Address 


Conf ig - 


Address 


Address 


Address 


Flags and 


System 


Address 


Address 




of 


u rat ion 


of 


of 


of 


Switches 


Task 


of 


of 




Channel 


Byte 


CRT 


Seek 


Channel 


(see 


Selection 


Task 


PD Area 




Buckets 


(see 
expan- 
sion) 


Table 


Address 

Block 

Table 


Control 
Table 


expansion] 


Control 

Field(see 

expansiori 


Selection 








I4C 


50 


54 


58 


5A 


5C 


60 


76 


80 


84 


88 


90 


92 


96 


Address 


Address 


Address 


Key of 


Key of 


Pointer to 


Address 


of Track 


of Timerof AB 


Task 


Task 


Power/VS 


of VTAM 


Hold 


Request 


Table 


Owning 


Running 


Partition 


Vector 


Table 


Table 




LTA 






Table 



64 


68 


6C 


70 


74 


78 


7C 


80 


100 


104 


108 


112 


116 


120 


124 


128 


Address 


Address 


Address 


Address 


Address 


Address 


Address 


Base 


of 


of 


of 


of 


of 


of PUB 


of Job 


Address 


RF 


EU ECE 


OLTEP 


RAS 


ASCII 


Owner 


Account 


of Page 


Table 


Table 


Bucket 


Linkage 


Translate 


ship 


ing 


Manage 








Area 


Table 


Table 


Common 
Table 


ment 
Routine 



Hex 


84 


88 


80 


90 


94 


98 


9C 


AO 


A1 


Dec 


132 


136 


140 


144 


148 


152 


156 


160 


161 




Base 


Address 


Address 


Address 


Address 


Address 


Address 


Align 


Pointer 




Address 


of 


of Line 


of 


of PTA 


of First 


of Task 


ment 


to 




of Chann- 


SDAID 


Mode 


VSAM 




System 


Block 


Byte 


SNS 




el Program 


Save 


Table 


Comm 




Task 


of 




Task 




Transia 


Area 




Ari!n 




Block 


active 




Block 




tion 












Systehn 








Routine 












Task 
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H«x 


A2 


A3 






A4 


A5 


A6 


A7 




A8 




A9 


AA 


1 


AB 


1 


AC 


AF 






Dk 


162 


163 


164 


165 


166 


167 


168 


169 


170 


171 


172 


175 






Pointer 


Pointer 


Pointer 


Reserved 


Pointer 


Pointer 


Reserved 


Pointer 


Reserved 


Pointer 


Reserved 


Pointer 






to 


to 


to 


X'OO" 


to 


to 


X'OO' 


to 


X'OO' 


to 


3X'00' 


to 






DSK 


RAS 


PMGR 




PAGE IN 


SUP 




CRT 




ERP 




SVT 






Task 


Task 


Task 




Task 


Task 




Task 




Task 




Task 






Block 


Block 


Block 




Block 


Block 




Block 




Block 




Block 




Hex 


80 


84 


88 


BC 


BE 


CO 


CB 


CC 


CE 


DO 




D4 


D8 




Dtc 


176 


180 


184 


188 


190 


192 


203 


204 


206 


208 




212 


216 






Address 


Address 


TRTMSK 


TP 


ID of 


Reiposi- 


plumber of 


Length 


Number 


Address 


Address 


Address 






of Task 


of 


pointer 


Balaffcing 


parti- 
tion 
' owning 
Task 


tJoning 


Error 


of PUB 


of 


of 




of Page 


of Page 






Timer 


MVCFLD 




Paramete 


information 


Queue 


Table 


Active 


Segment 


Franw 


Frame 






Table 








for 2560/ 


Entries 


in Bytes 


Partitions Table 




Table 


Table 














Timer 


5425 ERR 














Extension 




Hex 


DC EO 


E4 


E6 


E8 


EC 


FO 


F4 


F5 


F8 


FC 


too 




104 


Dk 


220 


224 


228 


230 


232 


236 


240 


244 


245 


248 


252 


256 


260 




Addr«M 


Addren 


Address 


Reserved 


Addrets 


Address 


Address 


SVA 


Address 


Address 


Address 


Pointer to 


Adress 




of 


of DPD 


of 




of 


of END 


of Fetch 


Flag 


of SVA 


of 


of RPS 


RPS Sector 


of 




Boundary 


Table 


System 




VIRTAD 


of Real 


table 


(See ^ 


System 


LDL m 


Calculation 


System 




Box 




Operator 




Routine 


Storage 




expansion) 


GETVIS 


SVA 


Routine 


Code 








Console 






(Fullword) 




r 


area 
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Dec 


Hex 


Description 






Flags and Switches 


47 


2F 


X'01 ' 3800 support generated 


52 


34 


Configuration byte 
X'06' Support for 3277 generated 
X'02' Support for 1 25D generated 
X'OO' Support for 321 0/321 5 generated 


64 


40 


Reserved for RMS support on the Models 1 1 5 and 1 25 

X'80' RMSR for channel attached devices, tapes and TP devices 

X'40' Full RMS support (MCAR/CCH and RMSR) 

X'20' MCAR/CCH support 


65 


41 


X'80' Initial selection of ERP 

X'40' Reserved 

X'20' Timer interrupt pending 

X'10' MICR Stacker-select active 

X'08' Invalid address during fetch 

X'04' SIO routine entered after interrupt 

X'02' TP in progress 

X'Or 1 PL in progress 


66 


42 


X'80' Initial RAS request 

X'40' RAS WAIT request outstanding 

X'20' RAS IPL in progress 

X'10' Reserved 

X'08' POWER/VS supported 

X'04' POWER/VS initialized 

X'02' GETRE AL for SDAI D in progress 

X'Or Fetch for system task in progress (used by PDAID s) 


67 


43 


X'40' ECPREAL support 
X'20' VSAM support 
X'08' XECB support generated 
X'04' TP Balancing reset request 
X'02' Batch deactivated 

System Task Selection Control Field 


68 


44 


Always zero 


69 


45 


SELECT byte: 

X'OO' No system task active 

X'Or SNS active 

X'02' DSK active 

X'03' RAS active 

X'04' PMGR active 

X'06' PAGE IN active 

X'07' SUP active 

X'09' CRT active 

X'OB' ERP active 

X'OF' SVT active 

SVA Flag 


244 


F4 


X'80' Do not test for warm start copy of SVA 

X'40' SDL active 

X'20' No 'Set SVA' or 'Set SDL' allowed 

X'10' Build of SDL in progress 

X'08' SDL overflow 

X'04'1 

X'02'> Reserved 

x'or; 



Figure 4.5 Expansion of SYSCOM flag bytes 
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The I/O tables and information blocks in the supervisor estabUsluthe interface 
between a specific task and the hardware channels. For example, for every logical 
unit name (SYSXXX) used, there must be a LUB (Logical Unit Block) entry. For 
every physical device used by the system, there must be a PUB (Physical Unit 
Block) entry. Then, when an I/O request occurs, an entry is made, via LUB and 
PUB, in the CHANQ (Channel Queue). An I/O request queued in the CHANQ 
contains an address that points to the CCB (Command Control Block) that 
contains the address of the channel program. 

During the I/O device operation, entries are made in the ERRQ (Error Queue) in 
the Error Recovery Block, if a hardware failure occurs on the device. 

The fold-out at the end of the book is an overall picture that illustrates the 
connections between the tables, (it does not represent their actual position, size, 
or relation as they are stored or printed\n a dump output). The initial pointers 
for all the tables and blocks are stored either in SYSCOM or in the active 
partition comreg. 

Where a connection exists between tables, for example, the PUB and the CHANQ, 
pointers are contained in the table entries concerned. For example the Figure 
shows a one-byte pointer in the PUB entry number 00 that relates this PUB entry 
to CHANQ entry number 00. 

Figures 4.6 through 4.15 show the format of the tables and describe their contents. 

A formatted stand-alone dump output prints the contents of the tables in a more 
readily understood format, and an example of such an output is shown in appendix 
G. The stand-alone dump program is described in Section 2-A of this manual. 



Section 4, Chapter 3 

I/O TABLES AND 
INFORMATION BLOCKS 
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The LUB table 

This table is built up during system generation by the lOTAB supervisor generation 
macro, according to the BGPGR and FnPGR parameters (where n is the partition 
number). The table has one entry for each logical unit required for the system. 
Each entry is two bytes long and entries are grouped into two classes: 

• System LUBs 

• Programmer LUBs 

There are always 14 system LUBs for each partition on the system. 

By examining the contents of this table you can see the logical units that: 

• Are unassigned or assigned (and, if assigned, to which entry in the PUB table) 

• Have a temporary assignment or an alternate assignment, or indicate that a 
DASD file is opened. 

How to locate: 

Bytes X'4C'— X'4D' in the partition communication regions contain the address 
of the first entry in this table. Label LUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The number of LUB entries for system logical units in the BG System LUB and the 
number of LUB entries for programmer logical units in each programmer LUB is 
stored in the NICL information block. 

NICL, (Number in Class List) 

Byte of this information block contains the number of System LUB entries (for 
DOS/VS, always 14, X'OE'). Byte 1 contains the number of programmer LUBs for 
the BG partition, and the remaining bytes contain the number of programmer LUBs 
for each foreground partition in the system (one byte per partition). 
The total number of bytes in the NICL is equal to the number of partitions in the 
system plus one. 

How to locate 

Bytes X'4A' — X'4B' of the partition comregs contain the address of the first entry 

in this information block. Label NICL in the supervisor Hsting identifies the 

address of the first byte of this information block. 

A pointer to the first entry in the LUB table and a pointer to the first LUB entry 

for the programmer LUBs for each partition is stored in the FICL information 

block. 

FICL, (First In Class List) 

Each byte of this information block points as a displacement index to the 
beginning of a LUB sector. 

Byte to the first LUB entry, and the remaining bytes to the first LUB entrys for 
each programmer LUB of each partition. The total number of bytes in the FICL is 
equal to the number of partitions in the system plus one. 

How to locate: 

Bytes X'48' — X'49' of the partition comregs contain the address of the first entry 
in this information block. Label FICL in the supervisor Hsting identifies the 
address of the first byte of this information block. 

Figure 4.6 (opposite) shows the format and contents of the LUB table, and expands 
one entry in order to explain its contents. The figure also shows the relationship 
between the LUB, NICL, and FICL. 
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Number in 
Class List 
(NICL) 



LUBTAB 



First in 
Class List 
(FICL) 
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SYS 








BG 

System LUBs 


"^ 


n 


-SYS 


W 




BG 












BG 

Programmer LUBs 






Fn 








t; 








i \ 


Fn 

System LUBs 


- F2 


F2 




1 


F1 


Fn 

Programmer LUBs 






r F1 








:*■ 






- 






F2 

System LUBs 






F2 

Programmer LUBs 














F1 

System LUBs 






F1 

Programmer LUBs 















System Lubs 



LUB Table for any 
Partition 



Programmer Lubs 



SYSRDR 

SYSIPT 

SYSPCH 

SYSLST 

SYSLOG 

SYSLNK 

SYSRES 

SYSSLB 

SYSRLB 

1) SYSUSE 
SYSREC 

.SYSCLB 
SYSVIS 
SYSCAT 
SYSOOO 
SYS001 
SYS002 
SYS003 
SYS004 

2) SYSnnn 



- Points to first PUB and PUBOWNER 

00000001 -Points to second PUB and PUBOWNER 
0000001 -Pointsto third PUB and PUBOWNER 



11111110— Ignore, assigned ignore 
1111111 1 - Null Pointer, the LUB is unassigned 
When a logical unit is assigned, the system inserts a pointer 
to the PUB for the physical device specified. 






ByteO 


Byte 1 


PUB Pointer 


JIB Pointer 



1 ) SYSUSE may be called SYSCTL in error recovery messages. 

2) The maximum number of programmer LUBs is 
as follows: 

241 forFl 

241 for BG if NPARTS=1 

241 -1 4 * (n-1 ) -1 if NPARTS > 1 

where n is the number of 

supported partitions. 



JIB Index (Multiply by 4 = Displacement into JIB Table) or 
X'FF' = Null Pointer, no JIB for this LUB. 

A LUB has a JIB pointer in three situations: 

1. The logical unit is temporarily assigned. 

2. The logical unit assignment is alternate (ALT). 

3. A DASD file (except a system I/O file on disk) is 
opened (DASD file protect only). 



Figure 4.6 The LUB table. 

The figure illustrates the format and contents of one entry and shows its relationship to the 
NICL and FICL information blocks. 
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The PUB table 

This table is built up during system generation by the lOTAB supervisor genera- 
tion macro and each DVCGEN macro fills one PUB entry in the PUB table. 



"-"X 



1^ 






By examining the contents of this table you can see both the physical address of 
each I/O device attached to the system and which devices are queued in the 
CHANQ. In conjunction with the contents of the LUB and JIB, you can ascertain 
the status of an I/O request for any logical unit. 

The number of bytes in the PUB table (its size) is determined during system 
generation, although the operator can ADD or DELETE I/O devices during IPL. 
The PUB is divided into seven parts, each part containing the I/O devices attached 
to one of the seven channels. The first entry in the PUB belongs to the I/O device 
with the highest priority on channel 0. A pointer to the first PUB entry for each 
channel on the system is stored in the FOCL information block. 

How to locate: 

Bytes X'40' - X%V of the partition communication regions contain the address 
of the first entry in this table. Label PUBTAB in the supervisor listing identifies 
the address of the first byte of this table. 

The figure below shows the format and describes the contents of an entry in the 
PUB. Figure 4.8 (opposite) details a PUB entry to bit level. 



PUBTAB 



Channel 
PUBs 



Channel 1 
PUBs 



Channel 6 
PUBs 



FF 



PUB-table 
delimiter 



l— PUBEND 



Job Control Flags 
Channel Scheduler Flags 

Device Type 

TEB Pointer 
Retry Counter 
Unit 









-Channel Queue Pointer 
- Channel 

Device Characteristic Code^ 

or SAB Pointer, 

or LINEMODE Pointer 



Figure 4.7 Format and contents of an entry in the PUB 



FOCL (First on Channel List) 

Byte of this information block points as a displacement index to the first PUB 
entry for the I/O device attached to channel 0, and byte 1 points to the first 
PUB entry for channel 1 . The remaining five bytes point to the first entries in 
the PUB belonging to channels 2 to 6. X'FF' indicates that the associated channel is 
not supported on the system. 

How to Locate: 

Bytes X'3E' - X'3F' of the partition communication regions contain the address 
of the first entry in this information block. Label FOCL in the supervisor listing 
identifies the address of the first byte of this information block. 
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ByteO 
Byte 1 
Byte 2 
Byte 3 

Byte 4: 
Byte 5: 



Byte 6: 



Byte 7: 
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Channel number. (Hex 0-6, FF = NULL) 
I/O device unit number 

Hex 0, 1,2, points to the first channel queue entry for this device. 

If device is a 2495 Tape Cartridge Reader and TEBs are specified, this 

byte is a TEB pointer (Hex 1 , 2, 3, ). Otherwise, this byte is a ERP retry counter. 

Device type code. See Figure 4.9, parts 1 through 3. 

SS of the MODE= parameter in the DVCGEN macro for tapje unit (See Section 2). 

For the Models 115 and 125 ICA line, this byte contains the displacement index of 

the entry in the Line Mode Table (LMT). The address of the LMT is contained 

in bytes X'8C - X'8F' of SYSCOM. 

For DASD with seek separation, this byte is used as the SAB Pointer. 

With Track Hold but not seek separation supported, this byte contains 

a pointer to the Track Hold Table entry or X'FF' (with both SKSEP and 

TRKHLD specified, the track hold pointer is found in the SAB entry). 

For MICR type devices, this byte indicates which external interrupt line 

is in use. 

For a 3704/3705 Communications Controller, this byte contains the type number 
of the Channel Adapter. 

For 2560 or 5425 

Bit 0: 1= Repositioning required 

1 : 0= SYSPCH temporarily assigned to hopper 1 
1= SYSPCH temporarily assigned to hopper 2 
2: 0= SYSIPT temporarily assigned to hopper 1 
1= SYSIPT temporarily assigned to hopper 2 
3: 0= SYSRDR temporarily assigned to hopper 1 
1= SYSRDR temporarily assigned to hopper 2 
5: 0= SYSPCH permanently assigned to hopper 1 
1 = SYSPCH permanently assigned to hopper 2 
6: 0= SYSIPT permanently assigned to hopper 1 
1= SYSIPT permanently assigned to hopper 2 
7: 0= SYSRDR permanently assigned to hopper 1 
1= SYSRDR permanently assigned to hopper 2. 
For 3800: 
Bits and 1 : 00=3800 

01=38006 (3800 with Burster-Trimmer-Stacker) 
10=3800C (3800 with additional character generation storage) 
1 1=3800BC (3800 with Burster-Trimmer-Stacker and additional 
character generation storage) 

Channel Scheduler Flags 

Bit 0: 1= Device busy 

1:1= Switchable device 

2: Reserved 

3: 1 = I/O error queued for recovery 

4:1= Operator intervention required 

5:1= Device End posting required 

6: 1= Burst mode overrunnable device on byte MPX channel 

7:1= 7-track tape unit 

Job Control Flags 

Bit 0-4: Standard MODE assignment for 7-track (all ones 

if not tape, all zeros if device is down) 
Bit 5: 1 = DASD device with Rotational Position Sensing (RPS) feature 
Bit 6-7: B'1 V (both on) = Headqueue in progress 

B'01' = Headqueue requested 



o 



Note: A null is generated for each device to be supported by the supervisor. Standard physical 

unit assignments are made to the PUB table at supervisor generation time. 

PUBs are ordered by channel and priority within a channel. 

An entry in the PUB Ownership Table is associated with each entry in the PUB Table, 

if the supervisor has been generated to support multiprogramming. 
Figure 4.8 Explanation of the contents of an entry in the PUB table 
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Card 


Actual IBM Device 


Device 




Code 




Type X'nn' 


Device Type 


2400T9 


9-track Magnetic Tape 
Tape units 


50 




2400T7 


7-track Magnetic 
Tape units 


50 




3410T9 


9-track 3410 Magnetic 


53 






Tape units 




Magnetic Tape devices 


3410T7 


7-track 3410 Magnetic 
Tape units 


53 




3420T9 


9-track 3420 Magnetic 
Tape units 


52 




3420T7 


7-track 3420 Magnetic 
Tape units 


52 




2495TC 


2495 Tape Cartridge 
Reader 


51 


Tape Cartridge Reader 


1442N1 


1442N1 Card Read Punch 


30 




2520B1 


2520B1 Card Read Punch 


31 




2560 


2560 Multifunction Card 


33 






machine 




Card Read Punches 


2596 


2596 Card Read Punch 


30 




3525RP 


3525 Card Punch (with 
optional read feature) 


32 




5425 


5425 Multifunction Card 
Unit 


34 




2501 


2501 Card Reader 


10 




2540R 


2540 Card Reader 


11 




3504 


3504 Card Reader 


12 


Card Readers 


3505 


3505 Card Reader 


12 




2540P 


2540 Card Punch 


21 




2520B2 


2520B2 Card Punch 


20 




1442N2 


1442N2 Card Punch 


22 


Card Punches 


2520B3 


2520B3 Card Punch 


20 




3525P 


3525 Card Punch 


23 




PRT1 


3203-4 or 321 1 printer 


43 




1403 


1403 Printer 


40 




1403U 


1403 Printer with DCS 
feature 


42 




1443 


1443 Printer 


41 




2245 


Kahji Printer 


44 




2260 (local) 


1053 Printer with 2848 
Control Unit. MODE 
operand must be entered 
as x'or 


CO 




3203 


3203 Printer 


4A 




3211 


SameasPRTI 


43 


Printers 


3277 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Control Unit. MODE 
operand must be entered 
as x'or 






32778 


3284 or 3286 Printer with 


BO 




(local 3270) 


3272 Conti-ol Unit, attached 
in burst mode to a multi- 
plexer channel. MODE 
operand must be entered 
asX'Or 






3800 


3800 Printing Subsystem 


45 




3800B 


3800 Printing Subsystem 
with optional Burster- 
Trimmer-Stacker 


45 








^ 
./ 



Figure 4.9 Device Type Codes, part 1 of 3 
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Card 
Code 


Actual 1 BM Device 


Device- 
Type X'nn' 


Device Type 


3800C 


3800 Printing Subsystem 
with additional character 
generation storage 


45 




3800BC 


3800 Printing Subsystem 
with Burster-Trimmer- 
Stacker and additional 
character generation storage 


45 




5203 


5203 Printer 


4C 




5203U 


5203 Printer with 
UCS feature 


4D 




1050A 


3210, 3215 Console 
Printer Keyboards 


00 


Printer-Keyboards 


125D 


Models 115 and 125 Integrated 
Video Display Unit 


B2 


Video Display Unit 


125DP 


Models 115 and 125 Integrated 

Video Display Unit 

With 5213 Console Printer 

attached 


B2 




UNSP 


Unsupported device 


FF 


Unsupported. No burst mode 
on multiplexer channel 


UNSPB 


Unsupported device 


FF 


Unsupported with burst 
mode on multiplexer 
channel 


2311 


231 1 Disk Storage device 


60 


DASD 


2314 


2314 Direct Access Storage 
Facility 


62 




2314 


2319 Disk Storage Facility 


62 




2321 


2321 Data Cell Drive 


61 




3330 


3330-1, 3330-2, or 3333-1 
Disk Storage 


63 




3330 


3350 in 3330 Compatibility 
mode 


63 




3330B 


3330-11 Disk Storage 


65 




3340 


3340 Disk Storage (general) 


68 




3340 


3340 Disk Storage with 








3348 Model 35 


69 




3340 


3340 Disk Storage with 








3348 Model 70 


6A 




3340 R 


3344 Direct Access Storage 


6A 




3350 


3350 Disk Storage 


67 




1419 


1255 Magnetic Character 


72 


MICR-Magnetic Ink 




Reader 




Character Recognition 


1419 


1259 Magnetic Character 
Reader 


72 


devices 


1419 


1419 Magnetic Character 
Reader 


72 




1419P 


1419 Dual Address Adapter 
Primary Control Unit 


73 




1419S 


1419 Dual Address Adapter 
Secondary Contr. Unit 


74 




2701 


2701/2715 Data Adapter 
Unit 


DO 


Teleprocessing lines 


2701 


Integrated Communications 
Adapter (Model 1 35) 


DO 




A 






A=SADO comm'd y^^^^^ 


2702 B 


2702 Transmission Control 


D1 


B=SAD1comm'd ^^ 


C 


Unit 




C=SAD2 comm'd ^^ „.^^ 


D 


_ 




D=SAD3 comm'd 
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Figure 4.9 Device Type Codes, part 2 of 3 
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Card 
Code 


Actual IBM Device 


Device 
Type X'nn' 


Device Type 


2703 
2703 
2703 
3704 
3705 
3791 L 


2703 Transmission Control 
Unit 

Integrated Communications 
Adapter (Models 115 and 125) 
3705 Communications Con- 
troller in Emulation MODE 

3704 Communication Control- 
ler in Network Control Mode 

3705 Communication Control- 
ler in Network Control Mode 
3791 Local Communication 
Controller 


D2 

D2 
D2 

DC 

DC 

DE 


Communication system 


2955 


2955 Data Adapter Unit 


D7 


Data Link for RETAIN 


1017 
2671 


1017 Paper Tape Reader 
with 2826 Control Unit 
2671 Paper Tape Reader 


78 
70 


Paper Tape Readers 


1018 


1018 Paper Tape Punch 
with 2826 Control Unit 


79 


Paper Tape Punch 


1419 

1419P 

1419S 


1270 Optical Reader/ 

Sorter 

1275 Optical Reader/ 

Sorter Primary Control Unit 

1275 Optical Reader/Sorter 

Secondary Control Unit 


72 
73 
74 


Optical Readers 


1287 
1288 
3881 
3886 


1287 Optical Reader 

1288 Optical Page Reader 
•3881 Optical Mark Reader 

3886 Optical Character 
Reader 


77 
77 
11 
7C 


Optical Readers 


3895 


3895 Document 
Reader/lnscriber 


7D 


Inscriber 


3540 


3540 Diskette I/O unit 


80 


DISKETTE 


2260 
3277 

(local 3270) 

3277B 
(local 3270) 


2260 Display Station 
3277 Display Station; 
MODE operand need not 
be entered 

3277 Display Station; 
attached in burst mode to 
a multiplexer channel. 
MODE operand need not 
be entered 


CO 
80 

80 


Display Stations 


7770 


7770 Audio Response Unit 


D3 


Audio Response unit 






/^O 
Vj 



y 



*Note: The logical unit names SYSIPT, SYSRDR, and SYSIN cannot be assigned 
to a 3881. 
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PUBOWNER (PUB ownership) 

An area in the supervisor is always reserved for this table. The number of entries 
is equal to the number of entries in the PUB, and each entry is two bytes long. 
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By examining the contents of this table in conjunction with the associated entry in 
the PUB, you can identify the partition using a particular 1/0 device, for example, 
when conflicting assignments are thought to be the cause of a system malfunction. 



How to locate: 

Bytes X'78' - X'7B' of SYSCOM contain the address of the first entry in this table. 
Label PUBOWNER in the supervisor listing identifies the address of the first byte 
of this table. The figure below shows the format and describes the contents of an 
entry in the PUBOWNER. 

Notes: The number of entries in the PUB Ownership table is equal to the number 
of entries in the PUB table. Associated with each PUB entry is an entry in the PUB 
Ownership table. 



PUBOWNER 










1 



Byte 0: Bit Reserved 

11= waiting for volume to be mounted 
2-7 Reserved 
Byte 1 : Identifies the partition that owns the PUB according to following table: 



Flag 


Partition owning PUB if number of partition is: 




2 


3 


4 


5 


x'or 


BG 


BG 


BG 


BG 


X'02' 


F1 


F2 


F3 


F4 


X'04' 




F1 


F2 


F3 


X'08' 






F1 


F2 


X'10' 








F1 


X'80' 


PUB owned by VTAM | 



m W/ 



Figure 4.10 Contents of an entry in the PUBOWNER. 

The relationship between the PUB, the PUBOWNER, and the FOCL is 
shown in the foldout at the end of this book. 
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The JIB (Job Information Block) 

An area in the supervisor is reserved for this information block during system 
generation by the JIB parameter of the lOTAB macro. This information block 
records any changes to the standard or permanent assignments made by the 
// ASSGN job control statement. Extent information is also recorded in the JIB 
when the supervisor supports the DASDFP feature. 

By examining the contents of an entry in the JIB and its associated LUB, PUB, 
and PUBOWNER entries you can identify the logical units that are temporarily 
assigned, the address of the I/O device, and the partition using the device. Useful 
information can also be obtained from the JIB about DASD extents (DASDFP only), 
for example, when it is not certain why the message INVALID SEEK ADDRESS 
is printed during the execution of a particular job. 

How to locate: 

Bytes X'44' — X'45' of the partition communication regions contain the address of 
the first entry in this information block. Label JIBTAB in the supervisor listing 
identifies the address of the first byte of this information block. 

Entries in the JIB are made: 

• when a temporary assignment is made 

• by alternate tape assignments 

• by DASD extent information (when the file protect feature 
is supported by the supervisor). 

The next available JIB entry is recorded in the FAVP. 

FAVP (First Available Pointer) 

This is a one-byte pointer to the next available JIB entry. It contains a hexadecimal 
displacement from the first entry in the JIB. If it contains X'FF', no more entries 
in the JIB are available. 

How to locate: 

Bytes X'42' - X'43' of the partition communication regions contain the address 
of this pointer. Label FAVP in the supervisor listing identifies the address of this 
one-byte pointer. 

Figure 4.1 1 (opposite) illustrates the format and contents of a JOB entry. Its 
relationship to the LUB and PUB is indicated in the foldout at the end of this 
publication. 









4.54 Debugging for Programmers, part 2 



Section 4, Chapter 3 



JIBTAB 
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1 


2 


3 



y 



\ 



/ 



X 



\ 



\ 



Number of entries (length of JIB table) 
is determined at supervisor generation 
time 



Note 1: Only when file-protect on DASD. 

Note 2: Two JIB's are required for a 2321/3330/3340/3350 extent; one for lower 

limit and one for upper limit. The lower limit defining JIB must 

be chained to the upper limit defining JIB. 

For 2321, byte 1 of this JIB contains the subcell number times 

10 plus the strip number in binary. 



Figure 4. 1 1 Explanation of the contents of an entry in the JIB. 



Byte(s) 


Description 


0-1 (Contents 
depends on the bit 
setting in byte 2) 


Bit setting 
Byte 2 


Contents 


Bit 0= 1 


LUB entry of stored standard assignment. 




Stored standarc 


(PUB and JIB pointer) 




assignment 




Bit 1 = 1 


Byte 0: PUB pointer 




Alternate 


Byte 1 : X'OO' 




assignment 




Bit 2= 1 


Byte 0: Cylinder lower limit 




2311/2314/ 


Byte 1 : Cylinder upper limit 




2319 Extent 


See Note 1 


Bit 3 = 1 


For 2321: 




2321 /3330/ 


Lower limit (Cell or combined 




3340/ 


subcell and strip), or 




3350 Extent 


Upper limit (Cell or combined 
subcell and strip) 

For 3330/ Cylinder lower limit, or 
3340/ 
3350: Cylinder upper limit (One cylinder 

number of the 3330/3340/3350 
uses two bytes) 

See Notes 1 and 2 


2 


Meaning if bit = 1 : 




Bit 0: Stored standard assignment 




Bit 1 : Alternate assignment 




Bit 2: 231 1/2314/2319 extent 




Bit 3: 2321 /3330/3340/3350 extent 




Bit 4: The alternate assignment indicated in bit 1 is permanent. 




This bit is also on when one of the extent indicators 




(bit 2 and bit 3) is on. 




Bit 5: Catalogued procedures processing 




Bit 6/7: Reserved. 


3 


Chain byte 




Contains the displacement index of the next JIB. 




X'FF' defines the end of the chain. 
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CHANQ (Channel Queue) 

The area in the supervisor reserved for this table is determined during system 
generation by the CHANQ parameter of the lOTAB macro. 

This table is used by the supervisor to schedule I/O operations. An entry is made 
in the channel queue whenever a request is made for an I/O operation, and the 
entry remains in the queue until the operation is completed. Thus, at any point 
in time, the queue will consist of entries for I/O operations in progress and I/O 
operations waiting for initiation. Whenever an I/O event completes, the queue is 
examined to see if an operation is waiting for the device, and if so,.the operation 
is initiated. 

Each entry made in this table occupies an eight-byte field. Entries are pointed to 
by a CHANQ POINTER contained in byte 2 of any PUB entry owning a device 
waiting for an I/O operation to complete. 

By examining the contents of this table together with the contents of the PUB 
table you can determine the following: 

• Whether a particular I/O device is waiting for an I/O operation to be completed. 

• The reason for an uncompleted operation. 

• How many I/O requests have been made for a particular device (by looking at 
the CHAIN byte). 

• The CCB (Command Control Block) address and, therefore, the channel 
program and I/O area used by a particular device. (The CCB and channel 
program are described in Chapter 5 in this Section.) 

• The identity of the task that requests an I/O operation for a particular 
device. 

• Whether the channel queue is completely occupied (probably causing a soft 
wait state). 

How to locate: 

Bytes X'25' - X'27' of SYSCOM contain the address of the first entry in this table. 
Label CHANQ in the supervisor listing identifies the address of the first byte of 
this table. 

The number of channel queue entries occupied at any given point in time depends 
on the I/O activity in the system. A one-byte pointer (FLPTR) points to the next 
eight-byte field in this table that is free for use. 



if \ 






FLPTR (Free List Pointer) 

This one-byte pointer contains the hex index from the beginning of the 

channel queue table to the next available CHANQ entry. When the channel queue 

is full, it contains X'FF'. 



How to locate: 

Byte X'24' of SYSCOM contains this information byte. Label FLPTR in the 
supervisor listing identifies the adress of the information byte. 



For a detailed description of the operation of the CHANQ and FLPTR refer to the 
DOS/VS Supervisor Logic manual. 

Figure 4,12 (opposite) shows the format and describes the contents of the CHANQ 
table, and the foldout figure at the end of this book illustrates the relationship 
between the PUB, CHANQ, and FLPTR. 



~~i. 



,y 
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Task requestor Identification 
LUB Displacement 

LUB Identification 

Requestor Identification 



/ 



P 



Chain byte 
CCB address 



/ 



X 



/ 



\ 



X 



The length of the queue is determined / 

at supervisor generation time / 



\ 



o 



\ 



\ 



\ 



nK = FF for any unused channel queue entries. 



Byte 0: Contains the index within the channel queue of the next entry in the free 

list or in the list for a specific device, or X'FF' when it is the last entry in the free 
list or a device list. 

Bytes 1 -3: Contains the CCB address for the specified device. 

Byte 4: Contains a code identifying the task making the I/O request. The one-byte entry 

indicates to which task the CCB belongs, and is in the form X'nk' where: 
n = user storage protection key. (Attention or system task = 0, BG task = 1, 
FG tasks = 2-5 depending on the number of partitions.) 
k = for Attention and all user tasks. 

1 for SNS 

2 for DSK 

3 for HAS 
4forPMGR 
6forPAGEIN 
7forSUPVR 
9 for CRT 
BforERP 

F for SVT 
If the I/O request is from a subtask, this byte does not identify the subtask, but 
the partition. See Appendix B for an explanation of the REQID. 

Byte 5: Contains pointer (displacement index) to the entire LUB table identifying the 

logical unit making the I/O request. This is doubled to get the actual displacement 
into the full LUB table. 

Byte 6: Contains X'FF' if the LUB is a programmer class, or the displacement within the 

partition LUB if it is a system class. 
(Not used by a non-MPS Supervisior.) 

Byte 7: Contains the displacement within the PIB table of the PIB of the task requesting 

I/O, or X'FF' when the channel queue entry is in the free list. 
(Not used by a non-MPS Supervisor.) See Appendix B for an explanation of 
theTKREQID. 



*Notes: FLPTR: The free list pointer contains the index within the channel 

queue of the first entry in the free list of X'FF' when the channel queue is 
full. Byte X'24 of the System Communication Region (SYSCOM) contains 
the address of the Free List Pointer. 
Label FLPTR identifies the location of the pointer (1 byte}. 

PUB byte 2: The PUB channel queue pointer contains the index 
within the channel queue of the first entry for a specific device. 



Figure 4.12. Explanation of the contents of an entry in CHANQ. 
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Channel Control Table. 

This table contains a code identifying the channel types attached to the system. 
There is one entry for each channel attached, and each entry is two bytes long. 

No system generation macro is required to reserve an area in the supervisor for this 
table; information is entered into it by the STORE CHANNEL ID instruction during 
IPL. 






How to locate: 

Bytes X'3C' - X'3F' of SYSCOM contain the address of the first entry in this 
table. Label CHNTAB in the supervisor listing identifies the address of the first byte 
of this table. 

Figure 4. 13 (opposite) lists the meaning of the code contained in byte of this 
table; byte 1 is always zero. 



Channel bucket 

This information block is always generated in a supervisor. Each channel attached 
to the system owns a 24-byte field in this information block, which records the 
contents of the I/O registers (general registers 1 , 2, 3, and 4) and a pointer to the 
PIB (Program Information Block) for the last 1/0 started on each channel. 

Its size, or the number of bytes reserved for this information block, is always 
sufficient to allow a 24-byte field for each of the 7 channels, whether attached to 
the system or not. 

By examining the contents of this block, information relating to the last I/O started 
on any attached channel can be obtained. 

Similar information can be obtained by examining the contents of the PUB, CHANQ, 
and FOCL, but the channel bucket formats the information and, in addition, 
contains a pointer to the PIB. Information in the PIB allows more details about 
the task issuing the last START I/O instruction to be obtained. (The PIB is 
described in chapter 7 in this Section.) 






How to locate: 

Bytes X'30' - X'33' of SYSCOM contain the address of the first entry in this 
information block. Label REGSAV in the supervisor listing identifies the address 
of the first byte in this information block. 

Figure 4.14 opposite) shows the format and contents of an entry made in the 
channel bucket for a system. 
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Channel 1 


Ch»ine) 2 


Channel 3 


Channel 4 


Channel 5 


Channel 6 
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\ 
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/ 



\ 



/ 



\ 



/ 
/ 




\ 


Byte 0: 


X'10' = Byte Multiplexer Channel 

X'1 1 ' = Byte Multiplexer Channel with burst mode support 

X'13' = Byte Multiplexer Channel running in burst mode 

X'OO' = Selector Channel 

X'80' = Channel not operational or not present in the system 

X'20' = Block Multiplexer Channel 




Byte 1 : 


Always zero 





Figure 4.13 Explanation of the contents of the Channel Control Table 



w 



REGSAV 



/ 



\ 



Bytes 



^ 



3 3 


4 




7 


8 11 12 


15 


16 19 


20 


23 


Address of first 
PUB on Channel 


CCB Pointer 


Device Address 


PUB Pointer 


Channel Queue 
Pointer 


PIB Pointer 



Notes: 1 A channel bucket contains information related to the last I/O started on the channel. 

2 The number of channel buckets in a system equals the number of I/O channels in the system. 

Figure 4.14 Contents of the Channel Bucket 
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Error Recovery Block and Error Queue 

Real storage area is reserved in the supervisor for the error recovery block during 
system generation by the ERRQ parameter of the FOPT macro. 

The block is used by error queue entries that are built up by the supervisor in the 
event of an I/O device error during program operation. 

Data recorded in an error queue entry is used by both the ERP (Error Recovery 
Procedure) and RMSR (Recovery Management Support Recorder) routines. 

Each error queue entry is 44 bytes long (hex 2C), and the number of entries 
determined by the ERRQ parameter can be between 3 and 25 for a supervisor not 
supporting multiprogramming, or between 5 and 25 for a supervisor supporting 
multiprogramming. 

On the occurrence of an I/O device error that can not be corrected by hardware or 
software error recovery, a message is printed on SYSLOG. The message may require 
operator response or action, and contains data recorded in the error queue. An 
example of this type of message is: 

BG 0P47A UNX INTERV SYS003=2A1 

CCSW=021 000B49002000000 CCB=00B440 
SNS=40200004024024 1 0000000000089 2 B 1 61 4020 1 0200 1 AOO 1 






If no message can be printed because of the severity of the error, for example, a 
hard wait state, data recorded in the error queue should be analyzed in a dump 
output. 

By examining the contents of the error queue the following information can be 
obtained about any I/O device error recorded in the queue: 

• The status of the I/O device and the last CCW issued. 

• The active entries, if any (X'Ol' in byte 10). 

• The address of the associated PUB entry, from which the device address 
can be found. 

• The message code. (This code may refer to a DOS/VS message. For example, 
code 08 refers to device error recovery message 0P08A. The reason for the 
error and possible solutions are listed in DOS/VS Messages.) 

• The address of the associated CCB, from which the address of the channel 
program and I/O area used in the operation can be located. 



\y 



How to locate: 

Bytes X'OO' - '04' of SYSCOM contain the address of the first byte in this 
information block. Label ERBLOG in the supervisor listing identifies the address 
of the first byte of this information block. 

Figure 4.15 (opposite) illustrates the format and describes the contents of an error 
queue entry. 
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ERRQ1 
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7 


8 9 


10 11 


12 13 


14 15 


First error queue entry 


Name of phase 
to be fetched 
(always begins 
$$ABERRA) 


Branch address 
to retry the 
the failing 
operation 


Branch address 
to ignore the 
error 


Branch address 
to cancel the 
task 


Return address 
for A-transient 





v^ 



^ 



ERROR 
QUEUE TABLE 

ERRQ1 



V 

The A-transient loads one of these address in 
register 14 before branching to the return address 
(see bytes 14-15). 



Flag byte 



PUB address 







10 



-Message code 



12 



1516 1920 



Disk seek address 



csw 










CCB 
Address 


Sense data or 
Altern .entry name 



/ 



/ 



/ 



/ 



/ 



/ 



/ 



\ 



\ 



\ 



\ 



\ 



zL 






Bytes 0- 7: 
Bytes 8- 9: 
Byte 1 : 



Byte 1 1 



CSW 

Address of PUB for device in error. 

Flag byte: Bit 0: 1= No record found on DASD 

1: 1= Intervention required 

2: 1= Passback (Set by device ERP) 

3: 1= Allow ignore 

4: Not used 

5: 1= Allow retry 

6: Not used 

7: 1= Active entry. 

Message code: may refer to a device error recovery message generated 
by physical IOCS. (See DOS/VS Messages manual.) 



This location may contain one of the following: 

X'E2' = The error is recoverable. 

X'AE' = A record is to be recorded on the system recorder file for SVC44 

or a BTAM appendage routine, and a Physical Transient is to be fetched 

(last two characters of phasename are in bytes 20-21 ). 

Bytes 12-15: Disk seek address or address of affected PIB (for alternate entry) 

Bytes 1 6-1 9: Address of CCB 

Bytes 20-43: Sense data: The number of sense bytes generated depends on the options 
specified; the minimum is 24 bytes. 



Alternate entry name: If byte 11 contains X'AE', bytes 20-21 contain the last 
two characters of the phase name of the Physical Transient to be fetched for 
SVC 44 (A3) or BTAM (A5). 

X'AF' in byte 22 indicates that the I/O area associated with an alternate entry has 
been fixed temporarily 



Figure 4.1 5 Explanation of the contents of the Error Block and an entry in the Error Queue 
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The data management facilities of DOS/VS are provided for by a group of routines 
collectively referred to as input/output control system (IOCS). A distinction is 
made between tM^o types of routines: 

1. Physical IOCS (PIOCS). The physical unit I/O routines included in the 
supervisor. 

2. Logical IOCS (LIOCS). The logical unit I/O routines linked with the user's 
problem program. 



(f v. 



Physical IOCS 

Physical IOCS controls the actual transfer of data between the external medium 
and real storage. It performs the functions of initiating the execution of channel 
commands and handling associated I/O interrupts. Physical IOCS consists of the 
following routines: 

• Start I/O routine 

• I/O interrupt routine 

• Channel scheduler 

• Device error routines. 



Logical IOCS 

Logical IOCS performs the functions a user needs to locate and address a logical 
record for processing. A logical record is one unit of information in a file of like 
units, such as one employee's record in a master payroll file, one part number in an 
inventory file, or one customer account record in an account file. One or many 
logical records may be included within one physical record, such as a physical tape 
record (gap-to-gap). The term logical IOCS refers to the routines that perform the 
following functions: 

• Blocking and deblocking records 

• Switching between I/O areas when two areas are specified for a file 

• Handling end-of-file and end-of-volume conditions 

• Translating American National Standard Code for Information Interchange 
(ASCII) into Extended Binary Coded Decimal Interchange Code (EBCDIC) 
on input, and EBCDIC into ASCII on output 

• Checking and writing labels. 

A user's problem program normally uses LIOCS for file processing (this applies 
also to programs using POWER/VS and VSAM files). LIOCS uses PIOCS to perform 
the data transfers. Figure 4.16 (opposite) illustrates the relationship between LIOCS 
and PIOCS using the GET macro instruction in a user program. 






J' 
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o 



PROBLEM 
PROGRAM 



Issue GET «— 

request (refer 

to the file 

dsscription 

elsewhere 

in the program). 



Next instruction 
after GET 
request. 



LOGICAL 
IOCS 



Provide a new 
logical record from 
a physical block in 
the I/O area 

I (deblock) 
to the 
problem program, 

OR 

If actual input is 
required (new ■ 
block), issue a 
physical read 
request (EXCP. 
and J L ■" 

WAIT 

When I/O is com- 
plete, provide the 
first (or only) 
logical record from 
the new block in 
the I/O area to the 
I problem 
program. 



PHYSICAL 
IOCS 



Determine channel 
and: 

a) If channel is not 
*»- busy, start I/O — — 



b) 



If channel is busy, 
place request into 
channel queue and 
return to LI OS. 
(Supervisor will 
retry later.) 



When I/O is com- 
plete, return to 
LIOCS via interrupt 
handling routine 
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I/O 
DEVICE 



Start device 



Data transfer 



I/O complete 

, iJ 



Figure 4.16 Example of LIOCS and PIOCS interrelationship. 



Explanation of Figure 4.16: 

Logical IOCS makes a request to physicallOCS to start an I/O operation by means 
of the EXCP macro instruction. From information in the CCB, physical IOCS 
determines the channel for which the request was made and places the request on 
a queue for that device. If the channel(s) or device is not busy, the I/O is started 
and control returns to the problem program. If the channel is busy, control 
returns to the supervisor task selection routines, but the I/O request waits in the 
Channel queue. When the request reaches the top of the channel queue, the I/O 
is started. 

Control returns to the program requesting the I/O unless there was an error 
condition detected on the START I/O (SIO) instruction. The problem program 
normally continues processing until it requires that the requested I/O operation 
be complete (either the information being read into real storage is needed, or the 
output area must be freed on an output operation). At this time, the WAIT macro 
causes the now waiting task to be removed from task selection until the proper 
interrupt is processed for this device by the supervisor. 
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Using PIOCS and LIOCS Macro Instructions 

By use of macro instructions you can create, access and maintain files at both 
physical and logical IOCS levels. Through these macro instructions, the user can 
communicate with the pre-written routines and tailor them to his needs. 

As part of most user programs, LIOCS provides an interface between user programs, 
LIOCS provides an interface between user's file processing routines and PIOCS. 
(All COBOL, FORTRAN, RPG II, PL/IOPT and PL/I(D) programs use LIOCS; 
most assembler programs use LIOCS.) 

Using PIOCS 

Using PIOCS requires a detailed knowledge of device control and system operation. 
A channel program using the CCW assembler instruction must be written in con- 
junction with three macro instructions provided to communicate with PIOCS. 

CCB: This macro instruction generates a command control block. (Refer to 
Chapter 5 in this Section for a description of the CCB.) 

EXCP: This macro instruction is converted to an SVC to request execution of 
the channel program. It supplies the location of the corresponding CCB 
to the supervisor. 

WAIT: This macro instruction generates an SVC 7 which tests CCB byte 2 bit 
(traffic bit) to determine when an I/O operation is complete. If the 
operation is not complete, the supervisor gets control until PIOCS within 
the supervisor sets the traffic bit to indicate completion of the operation. 
The WAIT macro should always be used for each I/O operation. 

A channel program written to make use of the RPS feature of a direct-access 

device must contain Set Sector commands and either Read Sector commands 

or the SECTVAL macro instruction. 

SECTVAL: This macro instruction generates an SVC 75 to supply the 
sector in which the record is located. 

For information on the format of Sector CCWs and on Rotation Position 
Sensing see the Appropriate reference manual for the device. 

The example below shows part of an assembly program listing using the EXCP 
WAIT and CCB macros. A full description of these instructions can be found 
in DOS/ VS Supervisor and I/O Macros. 
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\ ,/ 



v,..,y 
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HH 
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IP 




Hi 




m 




• 


003B00 


♦7F0 


B7SC 


03F5E 


261 


B SKIP 








^^H 










262 


*••*••••***•••«•**••**••••••••*«••••••••**«•**•*••••*••**••••«*•**•*•*« 






^^H 


^^1 












263 


*BUG GENERATOR ROUTINE* 






^^B 


^^H 


• 










264 


********************»*********4******«*************************«******* 






^^H 


^^1 


003B04 


5010 


C61E 


04E20 


265 


BUC ST I.RISAVE SAVE CONTENTS OF RETURN REGISTER 






^^B 


^^1 












266 


EXCP TCC8I 






^^1 


^^H 


• 










270 


MAIT TCCBl 






^^H 


^^1 










276 


EXCP TCC82 






^^1 


^^1 












280 


MAIT TCCB2 






^^1 


^^1 


• 


003B30 


9640 


C83F 


050*1 


286 


01 0PRESPI.X<40> 






^^1 


■ 


003B34 


9503 


C83F 


05041 


287 

11 


CLI OPRESPltC'L" 


(r. 


83 /C^ 


■ 


■ 


■1 


MHI 


IH 


■MH 




m 


m 


■ 



■ 








m 


1 


• 004E90 4040404040404040 


15*/ n\ BC CH' ' 

1348 TOWN DC CH0> • 

1349 TCCBl CCB SYSLOC.TCCWl , X <0400« 
1360 TCCB2 CCB SYSLOG.TCCW2.X<0400' 




1 




^ 004EBA 000000000000 








^^1 


004ECO 09004F106000001C 


1371 TCCMl CCW 09,MSSG1,X'60',28 




^^B 


^^1 


^ 004EC8 09004F2C60000020 


1372 CCW 09,MSSG2,X>60>,32 




^^H 


^^1 


• 004E00 09004F4C6000002F 


1373 CCW 09,MSSG3,X'60',47 




^^B 


^^1 


004E08 a9004F7B6000001F 


1374 CCW 09,MSSG4,X"60»,31 




^^B 


^^1 


. 004EE0 09004F9A60000021 


1375 CCW 09,MSSG5,X»60«,33 




^^1 


^^1 


* 004EE8 09004FBB60O00021 


1376 CCW 09,MSSG6,X'60',33 




^^B 


^^1 


004EF0 09004FOC60000020 


1377 CCW 09,MSSG7,X>60',32 




^^1 


^^1 


^ 004EF8 09004FFC60000020 


1378 CCW 09,MSSG8,X>60<,32 




^^1 


^^1 


• 004F00 0900501C2000002 5 


1379 CCW 09,MSSG9,X'20',37 




^^1 


■ 


004F08 0A005O412O000001 


1380 TCCW2 CCW 10,0PRESP1.X»20' , 1 

1381 »»»♦♦»*•»»*♦»♦**«»»»»»»**»»*»»»»»»»*»♦*♦»♦»••»*»•»**♦♦*••♦*»♦»»»**••*•• 


Q-y yf y0lt 


■ 


■ 




1382 *MESSAGE CONSTANTS* 


■ 


I 


BJHBBHBHHI 






■ 



.^ 
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Using L/OCS 

Logical IOCS requires a minimum knowledge of the hardware I/O devices and is 
easily implemented within the problem program by the coding of macros. This 
system is also used by most of the high-level languages to control I/O operations. 

Two types of macro instructions are available to communicate with LIOCS. 

• Imperative Macros 

These macros order an action to be performed. For example, the macro GET 
commands LIOCS to place the next record in the user's problem program area. 

• Declarative Macros 

These macros supply information about the file and about types of processing the 
I/O routine will have to perform for the user. 
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Imperative l\/lacros 

The problem programmer issues imperative logical IOCS macro instructions to 
initiate such functions as opening a file, making records available for processing, 
writing records that have been processed, and controlling physical device operations. 
A full list can be found in DOSIVS LIOCS Vol 1. 






Declarative macros DTF (Define the File) Macros 

For each imperative macro issued by the problem program, the assembler program 
generates an in-line expansion that links the instruction to the DTF table (and 
consequently, the logic module) for the specified file. As an operand, the imperative 
macro instruction must always contain the filename in the DTF macro describing 
the file. 

For VSAM files, the DTF macro is replaced by the ACB, EXLST and RPL macros 
to describe a file. 

Whenever logical IOCS imperative macro instructions are used in a problem program 
to control the transfer of records in a file, that file must be defined by a declarative 
DTF macro instruction. The DTF macro instruction describes (through various 
parameters specified by the problem programmer) the characteristics of the logical 
file, indicates the type of processing for the file, and specifies the virtual storage 
areas and routines, Figure 4.18 summarizes the various DTF table types supported 
by DOS/VS. Detailed descriptions of the logical IOCS file definition (DTF) macros 
and their parameters are described in Supervisor and I/O Macros. 

When one of these DTF macro instructions is encountered at assembly time, the 
assembler builds a DTF table tailored to the DTF parameters. The table contains: 

• Device CCB 

• A V-type address constant used by the Linkage Editor to resolve the linkage to the 
logic module with this DTF 

• Logic indicators; that is, one I/O area, two I/O areas, device type, etc. 

• Addresses of all of the areas (except work areas) and control functions used by 
this device. 
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Regardless of the method of assembling logic modules and DTF tables (that is, 
together with the main program or separately), a symbolic linkage results between 
the DTF table and the logic module. The Linkage Editor resolves this linkage at 
edit time. 



rr> 
^^.J" 



Byte 


Bits 


Function 


0-15 




CCB. 


(0-F) 






16 




X'08' indicates DTF 


(10) 




relocated by OPENR. 


17-19 




Address of logic module. 


(11-13) 






20 




DTF type (X'10') 


(14) 






21 





1 = No rewind. 


(15) 


1 


1 = Unload rewind. 




2 


1 = Workfile. 




3 


1 = Read backward. 




4 


1 = Write. 




5 


1 = PCIIMTW. 




6 


1 = Force checking of read or write. 




7 


1 = Forward space before next operation. 


22-23 




Not used. 


(16-17) 






24-25 




Record length. 


(18-19) 






26-27 




Maximum BLKSIZE. 


(1A-1B) 






28 




Read op code. 


(1C) 






29-31 




EOF address. 


(1D-1F) 






32-39 




CCW. 


(20-27) 






40-43 




Block count, initialized 


(28-2 B) 




00000000 for read 
forward, 

00400000 for read 
backward. 


44 





1 = Error routine. 


(2C) 


1 


1 = Ignore. 




2 


1 = Read next record switch. 




3 


1 = Record fixed unblocked. 




4 


Not used. 




5 


Not used. 




6 


Not used. 




7 


Not used. 


45-47 




Address of error routine. 


(2D-2F) 







Note: Numbers in parentheses are displacements in hexadecimal 
notation. 

Figure 4.17 The format of the DTF table generated by a DTFMT declarative 
macro for a DTFMT workfile. 



An example of an assembly program listing is shown in Figure 4.21 that shows the 
expansion of a DTFMT macro. The macro expansion was obtained by the use of 
the assembly control statement PRINT GEN (a useful aid to use when in doubt). 
Figure 4.22 shows how this same DTFMT is printed in a system dump. The table of 
Figure 4.18 (opposite) lists all the DTF codes and relates them to their specific 
files. 



.„^ 
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(Byte 20) 


DTF 


Description 


of DTF Table 






X'OO' 




DTFCD 


Combined files 


x'or 




DTFPT 


Paper tape files 


X'02' 




DTFCD 


Reader and 3881 Optical Mark Reader files 


X'03' 




DTFCN 


Console 


X'04' 




DTFCD 


Punch files 


X'08' 




DTFPR 


Printer files 


X'09' 




DTFOR 


Optical Reader files except 3881 files 


X'OA' 




DTFOR 


Optical Reader files (HEADER=YES) 


X'OB' 




DTF MR 


Magnetic Ink Character Recognition (MICR) and Optical Reader/Sorter files 


X'OC 




DTFDR 


3886 Optical Character Reader files 


X'10' 




DTFMT 


Magnetic tape workfiles 






DTFCP 


Magnetic tape workfiles (compiler). (Note 1) 


x'lr 




DTFMT 


Nonstandard or unlabeled tape files 


X'12' 




DTFMT 


Standard labeled, output tape files 






DTFPH 


Standard labeled, output tape files (physical IOCS) 


X'13' 




DTFMT 


Standard labeled, input tape files (read backward) 


X'14' 




DTFMT 


Standard labeled, input tape files (read forward) 


X'lA' 




DTFDU 


3540 Diskette I/O Unit files 


X'20' 




DTFSD 


Sequential DASD workfiles and data files 






DTFCP 


DASD workfiles (compiler) 


X'21' 




DTFPH 


Sequential DASD files, MOUNTED=SINGLE (physical IOCS) 


X'22' 




DTFDA 


Direct access files 


X'23' 




DTFPH 


Direct access files, MOUNTED=ALL (physical IOCS) 


X'24' 




DTF IS 


Indexed sequential, LOAD file 


X'25' 




DTFIS 


Indexed sequential, ADD file 


X'26' 




DTFIS 


Indexed sequential, RETRVE file 


X'27' 




DTFIS 


Indexed sequential, ADDRTR file 


X'28' 




ACB 


Access Method Control Block for VSAM files 


X'30' 




DTFCP 


Compiler file for DOS Version 1 (Note 1 ) 


X'3r 




DTFCP 


Compiler file for DOS Versions 2 and 3 


X'32' 




DTFCP 


Compiler file for DOS Versions 2 and 3 (Note 2) 


X'33' 




DTFDI 


Device independent system unit files 


X'40' 




DTFBT 


Basic Telecommunications Access Method (BTAM) file (Notes 3 and 4) 


X'50' 




DTFQT 


Queued Telecommunications Access Method (QTAM) file (Notes 3 and 4) 


X'60' 








through 






Reserved 


X'67' 








Note 1: 


DTF type is X'30' except for tape or DASD assigned to units SYSOOO to SYSnnn. In this case, the DTFCP open 




phases change the DTF type to X'W for tape work files, or X'20' for DASD work files. 


Note 2: 


DTF type is X'32' except for DASD assigned to units SYSOOO to SYSnnn. In this case, the DTFCP open phases 




change the DTF type to X'20' for DASD workfiles. 


Note 3: 


The following control unit codes are ORed into the low-order 4 bits of the DTF type code. 




Control Unit Code 




7770 1 




2848 3 




2701 4 




2702 5 




2703 6 


Note 4: 


The DTF tables for BTAM and QTAM files are not documented in this manual. They are documented in the respective 




publications DOS/VS BTAM Logic and DOS/VS QTAM Logic. 


Note 5: 


VSAM differs from other DOS/VS access methods in that it does not use a DTF. The declarative macro equivalent for 




VSAM is the ACB. (Access Control Block). 



o 



Figure 4.18 DTF type codes. 
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MOD (Module Generation) Macros 

To speed up assembly time and save storage, LIOCS uses another type of 
declarative macro instruction. Called logic module generation macros, declaratives 
of the form xxMOD describe the type of processing that the I/O routines will 
have to do for a particular file. A module is generated that handles only v^hat the 
user has specified. 

The module generation macros generate the data handling logic modules. These 
modules contain generalized routines needed to perform the functions of the 
logical IOCS imperative macros. The generalized routines in the logic modules are 
altered and made more specific through various parameters (specified by the 
problem programmer) included in the xxMOD macro statements. It is possible, 
therefore, to generate many variations of a particular type of logic module, each 
specifically suited to the need of the problem programmer. 

At assembly time, the assembler produces an EXTRN (External Symbol) card for 
every V-type constant (or EXTRN statement) in the user program. The assembler 
expansion of the DTP statement produces an EXTRN card with the name of the 
logic module needed to support the parameters that were specified in the DTP 
macro. The IBM-generated module names indicate the type of file and the support 
that each is capable of supplying for the DTP. Refer to Pigure 4.19 for a breakdown 
of these names. Because of the descriptive nature of the IBM standard names, the 
programmer should be careful when specifying his own names for the logic modules 
to avoid overriding the IBM standard names. At the time this program is link- 
edited, the linkage editor resolves these EXTRN symbols (AUTOLINK). If the 
program is not to be executed immediately, option CATAL causes the linkage 
editor to catalog the program into the core image library. 
The modules can also be assembled in the user program together with the DTPs. 






1 


H 
J 
K 


xxxxxx 




L 






rlJB 


System Service and System Control 




IJC 


Card logic 




IJD 


Printer logic 




IJE 


Paper tape logic 


DATA < 


IJF 


Magnetic tape logic 


MANAGEMENT 


IJG 


Sequential DASD logic 




IJH 


Indexed Sequential DASD logic 




IJI 


Direct Access DASD logic 




MJJ 


Device independent logic 




^IJL 


Teleprocessing routines 




IJM 


Optical Reader logic 


DATA < 
MANAGEMENT 


UN 
^IJU 


3540 Diskette I/O Unit logic 
Magnetic Readers logic 




IJW 


Utilities 




IJZ 


OLTEP 




IKQ 


VSAM 



/""■X^ 

KJ 



Figure 4.19 A list of module names and their prefixes. 



Reenterable modules 

A re-enterable module is a logic module that can be used asynchronously, or shared 
by more than one file. The RDONLY (read only) parameter implies that the 
generated logic module is never modified in any way, regardless of the processing 
requirements of any file(s) using the module. To provide this feature, unique save 
areas extemal to the logic module are estabhshed, one for each task using the 
module. Each save area must be 72 bytes and doubleword aligned. Before a logic 
module is entered or an imperative macro is issued to the file, the task must provide 
the address of its unique save area in register 13. 
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Interrelationships of the DTP and Module Macro Instructions 

The DTFCD, DTFDA, DTFDI, DTFDU, DTFMR, DTFMT, DTFOR, DTFPR, 
DTFPT, and DTFSD declarative macros are similar in that each of them generates 
a DTF table that references an IOCS logic module. The first 16 bytes of each table 
have the same format, that is, a command control block (CCB) and bytes 17 to 19 
contain a logic module address. The length of each table depends on the particular 
device and file type. Figure 4.18 lists the DTF device codes. To accomplish the 
linkage between the DTF table and the logic module, the assembler generates a 
V-type address constant in the DTF of a named CSECT in the logic module. To 
resolve this linkage, the Hnkage symbols (module names) must be identical. The 
Figure below shows the relationship of the program, the DTF, and the logic 
module. The assumed parameters have generated a request for a MTMOD named 
IJFFBCWZ. Based on this name, the linkage editor was able to locate the module. 
Hie GET statement generated coding to load the address of the DTF table into 
register 1 . This gives the program access to the MTMOD address, and the program 
branches to the required routine within the module. 
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Problem Program 



GET TAPE 




DTF Table 



TAPE DTFMT 



DC V(IJFFBCWZ) 



Module 



IJFFBCWZ MTMOD 



Figure 4.20 The relationship between imperative and declarative macros. 

See also Figure 4.23, 
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LOC 


OBJECT CODE AOORl 


AD0R2 


STMT SOURCE 


STATEMENT 


DOS/VS ASSEMBLER REL 29.0 


20.02 73-10-05 










664 TAPEOUT 


DTFMT 


BLKSIZE-800t 

DEVADDR-SYS003. 

FILABL-NO. 

lOAREAl-RITETAPE, 

RECFORM-FIXBLK, 

TYPEFLE-OUTPUTi 

WORKA-YESt 

RECSUE-80 




C 
C 
C 

c 
c 
c 
c 
c 










665+* MAGNETIC TAPE IOCS - DTFMT - 5745- 


SC-TAP - REL. 28.0 


02250028 




003FAS 






666 + 


DC 


OD'O' 




3-8 29400025 




A 003FA8 


000080000000 




667+TAPEOUT 


DC 


X*000080000003' 


CCB 


30300025 




^ 003FAE 


01 




668 + 


DC 


ALKl) 


LOGICAL UNIT CLASS 


30400025 




003FAF 


03 




669+ 


DC 


AL1(3) 


LOGICAL UNIT 


30500025 




^ 003FB0 


00003FEO 




670* 


DC 


AL4(IJF10060I 


CCM ADDRESS 


3-8 31000025 




C03FB4 


00000000 




671* 


DC 


4X'00' 


CCB-ST BYTEfCSM CCW ADDRESS 


3-8 31100025 




a03FB8 


00 




672 + 


DC 


ALl(O) 




3-8 31800025 




A 003FB9 


000000 




673 + 


DC 


VL3(IJFFZZWZ) 


ADDRESS OF LOGIC MODULE 


3-8 38500025 




^ 003FBC 


11 




674+ 


DC 


X'll' 


DTF TYPE 


39500025 




003FBD 


50 




675+ 


DC 


ALKaO) 


LOGICAL IOCS SWITCHES 


41300025 




^ 003FBE 


E3C1D7C5D6E4E34'0 




676+ 


DC 


CL8-TAPE0UT- 




41800025 




^ 003FC6 


01 




677+ 


DC 


X'Ol' 




42300025 




003FC7 


60 




678 + 


DC 


AL1(96) SWITCHES FOR OPEN 


3-8 45200025 




^ C03FC8 


00 




679+ 


DC 


ALKO) 


SWITCH ONE FDR OPEN AND CLOSE 47200025 ^H 




^ 003FC9 


000000 




680+ 


DC 


AL3(0> 


USER LABEL ROUTINE 


47700025 ^m 




003 FCC 


00 




681 + 


DC 


ALllO) SWITCH 


FOR OPEN AND CLOSE 


4860002 5 ^M 




^ 003 FCO 


003FCD 




682+ 


DC 


AL3(*) 




49000025 ^M 




^ C03FOO 


00000000 




683+ 


DC 


F'O' 


BLOCKCOUNT 


49100025 ^H 




003FD4 


86 BC F018 


00018 


684+ 


BXH 


lltl2. 24(15) 


DEBLOCKING FORWARD 


49700025 ^M 




A a03F08 


41 EE 0001 


00001 


685 + 


LA 


14,1(14) 


INCREASE BLOCKCOUNT BY ONE 


49800025 ^H 




^ 003 FOC 


4700 0000 00000 




686 + 


NOP 


0(0) 


LOAD USER lOREG 


50600025 ^H 




C03FE0 


010047A120000320 




687+IJF10060 




CCW X-01-.RITETAPE, 


X -20-, 800 


55600025 ^H 




a 003FEe 


000047A1 




68*8 + 


DC 


A(RITETAPE) 


ONE lOAREA 


3-10 56160026 ^H 




^ 003FEC 


000047A1 




689+IJF2O060 




DC A(RITETAPE) 


DEBLOCKER 1 


3-10 52050026 ^H 




003FF0 


00000050 




690+ 


DC 


F'SO' 


DEBLOCKER 2 


3-10 52100026 ^H 




^ 063FF4 


00004ACO 




691 + 


DC 


A«RITETAPE+B00-1) 


DEBLOCKER 3 


3-10 52150026 ^H 




^ 003FF8 


0320 




692 + 


DC 


Y(800) 


BLOCKSIZE 


52400025 ^H 




003FFA 


031F 




693 + 


DC 


¥(800-1) 


BLOCKSIZE-1 


52600025 ^H 




C03FFC 


004F 




694+ 
695 


DC 
MTMOD 


YI80-1) 

WORKA'YES 


RECSIZE-1 


3-8 52900025 ^H 










696+» MAGNETIC TAPE IOCS - MTMOD - 5745 


-SC-TAP - REL. 29.0 $0L29ZCN 00280029 ^H 




^ 000000 






697+IJFFDTF 


DSECT 






03160025 ^H 




^ 000000 


OOOOOOOOOOOOOOOO 




698+IJFFNM 


DC 


4F>0' 


CCB 


03200025 ^M 








00003 


699 + IJFFCB2 


ECU 


IJFFNM+3 


COMMUNICATION BYTE 2 


03240025 ^M 




A 000010 


00000000 




700+ 


DC 


A(0) 


ADDRESS OF LOGIC MODULE 


03480025 ^H 




• 00001* 


10 




701 + 


DC 


X'10» 


DTF TYPE 


03520025 ^H 




000015 


00 




702+IJFFSWI 


DC 


X'OO* 


LOGICAL IO:S SWITCHES 


03560025 ^H 




i^^^^OOOOl* 


C605C104C5404040 




703+ 


DC 


CtS'FNAME' 


^^^^^^^^^^^M 


^Q^^^j^^m 














HHHHHHHI 


HHHHHUHHIH 


IHHHHIHHHI 









Figure 4.21 An example of an assembly listing showing the expansion of a 
DTFMT macro instruction. 

The program was assembled using the PRINT GEN assembler control statement 




Figure 4.22 An example showing how the same DTFMT is printed in a dump. 
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OLDMSTR DTFMT 



MTMOD macro 



TYPEFLE=INPUT, 
RECFORM=FIXUNB, 

READ=FORWARD, 

REWIND=UNLOAD 

DE VADDR=SYS001, 

FILABL=STD, 

I0REG=(3), 

I0AREA1=AREA0NE, 

I0AREA2=AREATW0, 

LABADDR=CKOLDLAB, 

ERROPT=CKOLDBLK, 

WLRERR=REG6, 

EOFADDR=EOFMSTR 



MTMOD macro 







Instructions 
generated by 
the GET macro. 



-i-L1, = A(OLDMSTR) 

4L15, red) 




17-19 



IJFFZZZZ (Address 
of logic module) 



ccw- 



DC A(AREAONE)- 
DC A(AREATWO) 



ERROPT=YES, 
r— READ=FORWARD 
RECFORM=FIXUNB, 
TYPEFLE=INPUT 



\ f Logic Module 






IJFFZZZZ 



IJFFGET 
IJFFGET 

IJFFHU2 



B IJFFGET 



Start of GET routine 



SVC (Using CCB 
and CCW from DTF 



BR 14 



AREAONE 



I0AREA1 




-AREATWO I0AREA2 



Figure 4.23 A summary of the relationships between an imperative macro, a declarative macro, and a module 
generation macro specified in a program. 

The GET imperative macro is used in this illustration, which also shows the linkage between the generated DTF table and the 
logic module. 
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RPS (Rotational Position Sensing) Option 
System Support 

RPS support for devices attached to block multiplexer channels in full block 
multiplex m.ode (or their equivalent on Model 3 11 5/3 125 CPUs) is provided as an 
option in DOS/ VS. The option is specifiable at the operating system and device 
level. System support is provided at system generation time by coding the FOPT 
macro with RPS=YES. The IBM 3330/3333 and 3350 support RPS as a standard 
feature. The IBM 3340 supports RPS when 3340R is specified in the DVCGEN 
macro. Please note that Block Multiplexing cannot be used with the 2311-1/3330, 
231 1-1/3340, and 2314/3340 Series Compatibility Features, if your CPU is a 
Model 31 15 or a Model 3 125. 

Data Management Support 

RPS support will be provided dynamically in Data Management when the 
operating system and the device support and all of the following conditions are met: 

• One of the DASD access methods is being used, that is, the file is defined by one 
of the following DTFs: DTFSD, DTFDA, DTFIS, DTFDI, or DTFPH. 

• There is room in the user's virtual storage to extend the DTF. 

• An RPS version of the logic module necessary to process the DTF has been, or 
can be, loaded into the SVA. 

At OPEN time, if it is determined that the system and the device both support 
RPS, a bit is set in the DTF tables (see Figure 4.24). This bit will not be turned 
off until CLOSE time whether or not the other conditions for RPS support are 
met. Space is then obtained for the DTF extension. The amount is dependent on 
which access method is in use (see Figure 4.24). If space is unavailable, the 
DTF will be opened without RPS support. 

Determination as to which RPS logic module is required to process this DTF is 
made and the module is loaded into the SVA, unless it is already there in which 
case it is sharable across partitions. If the required logic module cannot be made 
available, OPEN releases the DTF extension space and the DTF is opened without 
RPS support. 

If the space for the DTF extension is available and the RPS logic module is loaded 
into the SVA, OPEN sets another bit in the DTF table indicating that the data set 
will be processed in RPS mode (see Figure 4.24). 

The first section of the DTF extension contains the RPS channel program (so that 
the pointer to the extension is also the pointer to the RPS CCW chain). The 
extension also contains CCW build and work areas necessary to construct the RPS 
channel program, a sector value bucket, and register and address save areas (see 
Figure 4.25 for DTF extension format). 

The addresses of the original channel program and logic module are saved in the 
extension while the address of the RPS channel program is put into bytes 9 - 11 of 
the DTF and the address of the RPS logic module is put into bytes 17-19. These 
pointers are restored at CLOSE time. 

The original DTF is used for all fields except the channel program so that no 
mapping between the DTF and the extension is required, (see Figure 4,26 for an 
overview of the OPEN.) 









_>■ 
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No program recompiling or relink-editing is required, though there must be enough 
dynamically allocatable space in the user's partition for the RPS extensions. Since 
RPS gets this space via the GETVIS macro, the SIZE= parameter must be 
specified in the program's EXEC statement. 

The DTP extension provides a register save area for the RPS logic modules since 
they are all reenterable and sharable between partitions. If the original non-RPS 
logic module is reenterable because it was coded read-only, the user-supplied save 
area will not be used. The RPS logic modules are supersets of functions needed 
to process the DTP. 

System Component Support 

System Components support RPS where there is a significant amount of DASD I/O. 
This support is provided by building RPS channel commands and then changing 
these to NO-OPs or TICs if the affected device or system does not support RPS. 

Wherever the component uses LIOCS for its I/O, this optional support is provided 
through the data management support of RPS. 

Where LIOCS is not used, the component logic interrogates the indicator set by 
OPEN for I/O using DTFPH or, when DTFPH is not used, the same PUB and 
COMREG indicators interrogated by OPEN. 
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The system components supporting RPS are : 

• POWER/VS 

• Supervisor Fetch and Paging I/O 

• Linkage Editor 

• Job Control 

• Librarian 

• Checkpoint/ Restart 

• System Utilities 





DTFDA 
DTFPH* 


DTFSD 
DTFPH* 


DTFSD 

(work 

files) 


DTFDI 


DTFIS 

(All) 


DTP offset: set at byte 


32(20) 


44(2C) 


37(25) 


42 (2 A) 


65(41) 


System supports 
RPS bit 


1 


1 


1 


7 


4,7# 


DTP lias been 
extended bit 


7 


7 


7 


1 


5 


Length of DTP 
extension 


512 


256 


256 


256 


384 



* DTFPH has no logic module; therefore, the only RPS processing done is the setting of the 
System Support RPS bit. 

# Bit 4 on - prime data resides on an RPS device 
Bit 7 on - index resides on an RPS device 



Figure 4.24 



DTFs for RPS Support 
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0(0) 



RPS Channel Program 
(variable length) 



Work Space 



176(B0) Address of Original Channel Program 180(B4) Address of Original Logic Module 



172(AC) Sector Values (up to 4) 



184(B8) 



72-Byte Register Save Area 



256(100) 



Additional Work Space 

not present for SAM or Device Independence 

(This field is 256 bytes for DAM and 1 28 bytes for ISAM) 






K..-./' 



Figure 4,25 DTF Extension Work Area for RPS 
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BEFORE OPEN 
(and after CLOSE) 



AFTER OPEN 





USER'S PROGRAM 
DTF 




I I.J 

1 


CCB ccwt 

- - modA 1 

Channel Program 










L-. 


Non-RPSnnodule 
( LI OCS module referred 
to by the DTF and link- 
edited with user's 
program 











USER'S PROGRAM 
DTF 



CCB CCW 



&- 



MOD 



f^ ^ 



Not used 

Sftf-ir^riifiMimii i-ii 



PWTBl^jj»»«« II IIIIII H, 

Not used by 
this DTF 



USER'S VIRTUAL STORAGE 



RPS CHANNEL PROGRAM 



(see Figure 4.25) 



I SHARED VIRTUAL AREA 

I 



L_ 









-9f- 


RPS LIOCS 
Module 














Figure 4.26 Effect of RPS Support on OPEN 

Extended Printer Buffering for the 3800 

If the output device is a 3800 Printing Subsystem (whether simulated by 
POWER/VS or not), extended printer buffering can be used. It is used if all of 
the following requirements are met: 

• The DTF is DTFDI, DTFPR, or DTFCF. 

• The OPEN or OPENR macro is issued. 

• Sufficient user GETVIS storage is available for a work area and buffers. 

• The extended buffering logic module can be loaded during OPEN. 

For further information, see DOS/VS IBM 3800 Printing Subsystem Programmer's 
Guide. 

When the requirements are met, OPEN changes the channel program address in the 
DTF to point to a gotten area called the DTF Extension Work Area. OPEN also 
changes the logic module address in the DTF to point to the extended buffering 
logic module. The original contents of these two DTF fields are saved in the DTF 
Extension Work Area and restored during CLOSE. 

The DTF Extension Work Area contains a pointer to a DTF Extension Buffer. If 
more than one DTF is open to the device, each Work Area points to the same 
Buffer. 

These areas are described here for debugging purposes. User programs should not 
access them directly, because their contents may change in a future release. Figure 
4.26.1 shows the format of the DTF Extension Work Area for extended printer 
buffering. Figure 4.26.2 shows the DTF Extension Buffer for extended printer 
buffering. 
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Displacement 
Dec (Hex) 


Length 
in bytes 


Description and/or Contents 





(0) 


4 


Address of DTF Extension Buffer 




4 


(4) 


4 


Address of PUB 




8 


(8) 


4 


Address of user DTF 




12 


(C) 


4 


Address of next DTF Extension Work Area 


in chain 


16 


(10) 


64 


Register save area, from register 1 to 




80 


(50) 


4 


Original CCW address from user DTF 




84 


(54) 


4 


Original logic module address from DTF 




88 


(58) 


10 


Miscellaneous 




98 


(62) 


30 


Reserved 





Figure 4.26.1 DTF Extension Work Area for Extended Printer Buffering 



Displacement 
Dec (Hex) 


Length 
in bytes 


Description and/or Contents 





(0) 


1 


Current table reference character (TRC) 


1 


(1) 


13 


Translate table for FCB channels 


14 


(E) 


2 


Length of one channel program and data area 


16 


(10) 


4 


Address of CCB for channel program being built 


20 


(14) 


4 


Address of CCB executing 


24 


(18) 


4 


Address of next CCW 


28 


(1C) 


4 


Lowest data address so far used 


32 


(20) 


4 


Address of FCB image (in Buffer) 


36 


(24) 


4 


Address of current byte in FCB image 


40 


(28) 


2 


One less than length of FCB image 


42 


(2A) 


1 


Miscellaneous 


43 


(2B) 


5 


Reserved 


48/^ 


(30) 


4048 


First CCB, channel program, data area, second 
CCB, channel program, data area, FCB image 






Figure 4.26.2 DTF Extension Buffer for Extended Printer Buffering 



The last thing in the DTF Extension Buffer is a copy of the contents of the forms 
control buffer. The area preceding this FCB image is split in half. Each half 
contains a CCB, channel program, and data area. 
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VSAM (Virtual Storage Access Method) I/O 

VSAM IOCS differs from that of other DOS/VS access methods as follows: 

• VSAM declarative macros are ACB, EXLST, and RPL instead of DTP and 
xxMOD. 

• VSAM routines are dynamically loaded into virtual storage when a VSAM 
file is opened. They are not assembled or link edited with the user's 
program. 

Declarative Macros 

The VSAM declarative macros are ACB, which creates an Access-Method Control 
Block; EXLST, which creates an Exit List; and RPL, which creates a Request 
Parameter List. The Access-Method Control Block (ACB) is like a DTP in that it 
defines the file to be processed. Opening a VSAM file involves opening the ACB 
for that file. The Request Parameter List (RPL) defines the parameters necessary 
for a particular execution of a request (imperative) macro. It contains some of the 
information, such as address of the user's work area, located in the DTP in other 
access methods. The Exit List (EXLST) contains the addresses of optional user 
exit routines. Up to four exit routines can be specified - one for handling end-of- 
file, one for handling logical errors, one for handling I/O errors, and one to allow 
user processing during VSAM I/O operations. 

Codes indicating errors resulting from execution of imperative macros are set in 
registers or in the ACB or RPL as described below. 

Imperative Macros 

The user's program issues imperative macros to open or close a file and to retrieve, 
add, delete, or update records. It can also issue imperative macros to generate, 
modify, display or test the control blocks created by the declarative macros. When 
control is returned to the user's program after execution of an imperative macro a 
"return code" is set in the low-order byte of register 15. The return code indicates 
the results of the macro execution. If an error or certain other exceptional 
conditions occur, an "error code" will be set in the ACB, the RPL, or in register 0, 
depending on the macro. Figure 4.27 summarizes the return codes and error codes 
issued by the imperative macros and user exit routines which can be used. More 
information on the return codes and user exits as well as a complete list of the error 
codes and their meanings is in the VSAM chapter of DOS/VS Supervisor and I/O 
Macros. 

An ACB, EXLST, or RPL can be created dynamically, during program execution, 
by using the GENCB macro. The fields in these control blocks can be modified 
during program exectution by using the MODCB macro. Refer to DOS/VS 
Supervisor and I/O Macros for information on how to write the GENCB and 
MODCB macros. 

RPL Debugging Hints 

If the RPL hold byte, 35(23), is set to XTF', the error occurred while the request 
was being executed by VSAM. Check the type of request byte, 29 (ID), to 
determine what request was active. If the request was a POINT, GET, or PUT, 
check the following parameters in the RPL (of GENCB for RPL) in your program 
to ensure that they are valid: 

Macro Check these RPL Parameters 



POINT 
GET 

PUT 



ARG and KEYLEN 

AREA and AREALEN 

IF OPTCD^DIR or OPTCD^SKP, also check ARG and KEYLEN 

AREA and RECLEN 



If the RPL parameters are specified correctly or if the type of request is other than 
POINT, GET, or PUT, the error is probably in VSAM itself. Save the dump, console 
log, and program listing and contact your IBM programming support representative. 

Note: MODCB, SHOWCB, and TESTCB macros also set the RPL Hold byte. If this 
byte was set by one of those macros, the type of request byte will have no meaning; 
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Section 4, Chapter 5 

pommand Control Block (CCB) CCB AND THE 

CHANNEL PROGRAM 
This information block is generated in the problem program during assembly or 

during program operation, depending on the methods of I/O control employed by 

the program. As described in Chapter 4 the CCB is generated as the first 16 bytes of 

a DTF when the program is using LIOCS. When using PIOCS, the CCB macro 

generates the CCB. 

The CCB establishes communication between the problem program and physical 
IOCS. The CCB is 16 bytes in length with eight major fields, and does not have to be 
aligned on a doubleword boundary. Eight optional bytes are generated if the user 
request that a sense operation be performed on the occurrence of an I/O error. 
Data transferred from the device to real storage during a sense operation provides 
information concerning unusual conditions detected in the last operation and the 
status of the device. All data in the CCB is in the hexadecimal format. 

By examining the contents of the CCB in a dump, the following information can 
be obtained about the associated I/O operation: 

• Whether the operation was completed (by inspecting the traffic bit and 
device -end bit) 

Status of the channel and device to which the I/O command was issued 
The logical unit involved in the operation 
Whether the CCB is in a real or a virtual partition 
The address of the channel program (the first CCW in a CCW string) 
The addresss of the next CCW to be executed in the channel program 
(Subtracting eight from this address gives the address of the last CCW used.) 

• The residual count associated with the last CCW. 

This count taken from the channel status word (CSW), is stored by PIOCS when 
the pointer to this CCB is removed from the channel queue. The residual count, in 
conjunction with the original count specified in the last CCW used, indicates the 
number of bytes transferred to or from the area designated by the CCW. When an 
input operation is terminated, the difference between the original count in the 
CCW and the residual count in the CSW is equal to the number of bytes transferred 
to storage. For an output operation, the difference is equal to the number of 
bytes transferred to the I/O device. 

Note: When all the following conditions have been met, bytes 9-1 1 will now be 
pointing to a non-RPS channel program in the DTF, but the one actually used 
has been released from the user's virtual save area: 

• RPS was in effect. 

• Tfie data set has been closed. 

• The CCB was generated as the first 1 6 bytes of a DTF 
in a program using LIOCS. 

When 3800 extended printer buffering is used, the CCB in the DTF is not used to 
schedule output to PIOCS. Instead, a CCB is built in user GETVIS storage (see 
Figure 4.26.1). 



o 
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CCBANDTHE 
CHANNEL PROGRAM 



How to locate 

1 . For programs using LIOCS, locate the address of the associated DTP in the 
program Hsting. Then use the linkage editor map to locale the i)TF' in the dump. 
The First 1 6 hytes of the \y\¥ is the (X^B. 



o 



2. For programs using PIOCS, locate the address of the ("CB macro in the program 
listing and use the linkage editor map to locate the (C'B in the dump. 

3. If the interrupt code in the PSW stt)red in the partition save area is 0(J or 07 
(SVC or SVC 7), the contents of general register I may contain the address of 
the CCB. To confirm whether the address in register I is thai of a C'(Ti, inspect 
the first few bytes starting from that address. (It is not difficult to recogni/e 

a valid CCB in a dump. See the example below.) 



Ff HEC 
CH 0-F 



BUGPRGCK 

800400 SC 
000420C8 
00000000 
004000FF 
OOOOFFFF 
BG AOOR 



( i>00»082"_ 
0A16180C 
00000000 
0OO0E64O 
OOOOOOOO 

IS 0004*0 



OOOOOOOO 
4 7000000 



OOOOOOOO 
OOOOSSOE 



12/06/73 ^^/ lO.*l.Si PACE I 
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Figure 4.32 The pointer and CCB in a dump 

Figure 4.27 parts 1, 2 and .3 illustrate the format and contents of the information 
contained in any CCB. 
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Reserved 








Transmis 


CSW 


Type 


for 


CCW 


for 


CCW 


Optional 


Count 


sion infor 
mation 


Status 
Bits 


Code 


logical 
IOCS 


Address 


physical 
IOCS 


Address 
in CSW 
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CCW 


1 


2 3 


4 56 7 


8 


9 11 


12 


13 15 


16 23 



Section 4, Chapter 5 

CCB ANDTHE 
CHANNEL PROGRAM 



Byte(s) 


Description 


0-1 Used for residual Count. 






2-3 Transmitting information 
between Physical IOCS 
& Problem Program 


Byte 2 


Set on by: 


BitO: 


Traffic Bit (Wait) (Note 5) 


PIOCS* 




Bit 1: 


End of File(/* or /&); 3211-UCSB Parity Check (Line 
Complete). (Note 2) 


PIOCS 




Bit 2: 


Irrecoverable I/O error 


PIOCS 




Bit 3: 


Accept Irrecoverable I/O error 


Problem Program 




Bit 4: 
Bit 5: 


5425 not ready, or return DASD Data Checks, 2671 
errors, 3540 Diskette Data Checks, or 101 7/1018 errors 
to the user; indicate action-type message for Video 
Display Unit 
Post at Device End (Note 5) 


Problem Program 




Bit 6: 


Return Tape Read Data Check; 1018 or 2560 Data 
Check; 2520, 2540, 2560, 3881 or 5425 Equipment 
Check; Accept 3504, 3505 or 3525 Perm. Error; 
DASD-Data Checks on Read or Verify Command; on 1 
321 1 or 2245 Passback Requested. 
(Notes 3, 6 and 8) 






Bit 7: 


User Error Routine 


Problem Program 


Byte 3 


Set on by: 


Bit 0: 


DASD-Data Check in Count Area; Permanent Error for 
3330, 3340, 3350; MICR-SCU Not Operational; 1 287/ 
1288-Data Check; 3211 -Print Check/Equipment Check; 
3540 Special Record Transferred. 


PIOCS 




Bit 1: 


DASD-Track Overrun; MICR-lntervention required; 
1287-Keyboard Correction in Journal Tape Mode; 1017- 
Broken Tape; 3211-Print Quality/Equipment Check. 


PIOCS 




Bit 2: 


DASD-End of Cylinder; MICR-(Note 4); 1287/1 288- 
Hopper Empty in Document Mode. 3211/2245-Line 
Position Error. (Note 7) 






Bit 3: 


2520, 3881 -Equipment Check; 2560, 3203. 5203, 
5425 Data Check/Equipment Check; Tape-Read 
Data Check; DASD-Any Data Check, 1287- Equipment 
Check; 1 01 7/1 01 8-Data Check; 321 1 -Print Check/Data | 
Check; 3504, 3505, 3525 Perm. Error, (Note 8); 
3540 Diskette Data Check. 


PIOCS 




Bit 4: 


Non-Recovery Questionable Condition: Card-Unusual 
Command Sequence; DASD- No Record Found; 1287/ 
1288- Document Jam or Torn Tape; 3211-UCSB Parity 
Check (Command retry); 5425 not ready 


PIOCS 




Bit 5: 


Retry on No Record Found Condition (2311, 2314, 
231 9, 3330, 3340, or 3350) 


Problem Program 




Bit 6: 


Carriage Channel 9 Overflow or Verify Error for DASD; 
1287-Document Mode-Late Stacker Select; 1288-End of 
Page. 


PIOCS 




Bit 7: 


Command Chaining, Retry from the next CCW to be 
executed 


Problem Program 



•Physical IOCS 

Figure 4.33 Explanation of the contents of the CCB, part 1 of 3 



l-»ebugging for Programmers, part 2 



Section 4, Chapter 5 

CCB ANDTHE 
CHANNEL PROGRAM 



Count 


Transmis- 
sion infor- 
mation 


CSW 

Status 

Bits 


Type 
Code 


Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Option 

Sense 

CCW 


al 


1 


2 3 


4 5 


6 7 


8 


9 11 


12 


13 15 


16 


23 



4" 

V 



Byte(s) 



4-5 CSW Status Bits 



6-7 Type Code 



Description 



Byte 4 (Note 1) 



Bit 0(32) Attention 

1 (33) Status Modifier 
2(34) Control Unit End 
3(35) Busy 
4(36) Channel End 
5(37) Device End 
6(38) Unit Check 
7(39) Unit Exception 



Byte 5 



Bit 0(40) Program Controlled 
Interruption 
1(41) Incorrect Length 
2(42) Program Check 
3(43) Protection Check 
4(44) Channel Data Check 
5(45) Channel Control Check 
6(46) Interf. Control Check 
7(47) Chaining Check 



Byte 6 



X'Ou' Original CCB (Bytes 9-1 1 and 1 3-1 5 contain virtual addresses 
X'2u' Translated CCB (Byte 9-1 1 contain real address, bytes 13-1 1 

virtual address) 
X'4u' BTAM request original CCB (Bytes 9-1 1 and 13-1 5 contain 

virtual addresses) 
X'6u' BTAM request translated CCB (Bytes 9-1 1 contain real address, 

bytes 13-1 5 virtual address) 
X'8u' User-translated CCB in virtual partition (Bytes 9-1 1 and 1 3-1 5 

contain real addresses) 

u: = The address in byte 7 refers to a System Logical Unit. 
1 = The address in byte 7 refers to a Programmer Logical Unit. 



Byte 7 



Hexadecimal representation of SYSnnn: 



SYSRDR 


= 


00 


SYSIPT 


= 


01 


SYSPCH 


= 


02 


SYSLST 


= 


03 


SYSLOG 


= 


04 


SYSLNK 


= 


05 


SYSRES 


= 


06 


SYSSLB 


= 


07 


SYSRLB 


= 


08 


SYSUSE 


= 


09 



SYSREC 


= OA 


SYSCLB 


--= OB 


SYSVIS 


= OC 


SYSCAT 


= OD 


SYSOOO 


= 00 


SYS001 


= 01 


SYS002 


= 02 


SYSnnn 




(Note 9) 








Figure 4.33 Explanation of the contents of the CCB, part 2 of 3 
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Count 


Transmis- 
sion infor- 
mation 


CSW 

Status 

Bits 




Type 
Code 




Reserved 
for 

logical 
IOCS 


CCW 
Address 


Reserved 
for 

physical 
IOCS 


CCW 
Address 
in CSW 


Optional 

Sense 

CCW 


1 


2 3 


4 


56 


7 


8 


9 11 


12 


13 15 16 23 






Byte(s) 



Reserved for 
Logical IOCS 



9-1 1 CCW Address 



1 2 Reserved for 
Physical IOCS 



1 3-1 5 CCW Address 
in CSW 



16-23 Optional 
Sense CCW 



Description 



Buffer Offset 
ASCII Input Tapes 

ASCII Output Tapes Fixed 

Variable 

Undefined 



X'00'-X'63' 

X'OO' 

X'OO' or X'04' 

X'OO" 



Virtual or real address of CCW associated with this CCB depending 
on byte 6: 

Real address if byte 6= X'2u', X'6u', or X'8u'; 
Virtual address if byte 6= X'Ou', or X'4u'. 



X'80' CCB being used by ERP 

X'40' Channel Appendage Routine present 

X'20' Sense Information desired 

X'10' Message writer 

X'08' EU Tape Error 

X'04' OLTEP Appendage available 

X'02' Tape ERP Read Opposite Recovery 

X'01 ' Seek Separation 



Virtual Address of CCW pointed to by CSW at Channel End 
(if byte 6= X'Bu', it is the real address) or address of the 
Channel End Appendage Routine 



8 bytes appended to the CCB when Sense Information is 
desired. 






Note 1 : Bytes 4 and 5 contain the status bytes of the Channel Status Word (Bits 32-47). 
If byte 2, bit 5 is on and device end results as a separate interrupt, device end 
will be OR-ed into CCB byte 4. 

Note 2: Indicates /* or/& statement on SYSRDR or SYSIPT. 
Byte 4, bit 7 (unit exception) is also on. 

Note 3: DASD data checks on count not returned. 

Note 4: For 1255/1259/1270/1275/1419, disengage. For 1275/1419D, I/O Error is 
external interrupt routine (Channel data check or bus-out check). 

Note 5: The traffic bit (Byte 2, bit 0) is normally set on at channel end to signify that the 
I/O was completed. If byte 2, bit 5 has been set on, the traffic bit and bits 2 and 6 
in byte 3 will be set on at device end. Also see Note 1 . 

Note 6: 1018 ERP does not support the Error Correction Function. 

Note 7: This error occurs as an equipment check, data check or FCB parity check. 
For 2245, this error occurs as a data check or FCB parity check. 

Note 8: For 3504, 3505, 3525 input or output files using ERROPT, byte 3-bit 3 is set on if a 

permanent error occurs. Byte 2-bit 6 is set on to allow you to accept permanent errors. 
Note 9: The maximum number of programmer LUBs is as follows: 

241 for F1 

241 for BG if NPARTS=1 

241-14 • (n-1) -1 if NPARTS > 1 

where n is the number of supported partitions. 

Figure 4.33 Explanation of the contents of the CCB, part 3 of 3. 
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The channel program 

A channel program consists of one or more CGWs (channel command words). The 
channel program is generated during assembly or during program operation, 
depending on the method of I/O control employed by the program. A CCW specifies 
the command, the storage area to be used for the I/O operation, and the action to 
be followed when the operation is completed. When a program is running in a 
virtual partition, the CCWs are copied into the real address area. 

Translation from the virtual I/O area addresses in the CCW to real addresses is 
accomplished either by the supervisor channel program translation routines, 
or by the user program if ECPREAL is used. 






The contents of CCWs should be inspected when the cause of a system malfunction 
leads you to suspect I/O operation errors. For example, parts of a program being 
overwritten and causing invaHd instructions, or unexpected information in your 
program I/O data area will probably cause a program check and generate incorrect 
output from your program. 

By examining the contents of the channel program the following information can 
be obtained: 

• VaUdity of the operation code and of the sequence of CCWs used. If either of 
these is invalid, an informatory message is normally printed on SYSLOG to 
help you to determine the cause of the error. 

(Consult the component manual for the I/O device for the valid codes and 
sequence of use;) 

• Data address in the last CCW used. Translated channel programs are 
destroyed in a system dump by the channel programs required for the DUMP 
and by channel programs started for other partitions. However, they can be 
located in a stand-alone dump, an example of which is shown in Appendix G. 
(Refer to chapter 12 in this section for methods of translating real addresses 
to virtual and vice-versa.) 

• Count in the CCW. This must be a byte count of one or more for any I/O 
operation not involving magnetic tape units. (For a transfer in channel (TIC) 
command, the count may be zero.) 

• When working with wrong length records or variable length records, the 
suppress length indicator should be set to 1 to prevent an error condition. 



\ 
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How to locate: 



Bits 8-31 of the CSW (Channel Status Word) stored in location X'40' of low 

address storage contain the address of the next CCW to be executed. Subtract 

eight from this address to obtain the address of the last CCW used, (Refer to 

Section 2-E-2 for details of low address storage.) 

Caution: The data stored in low address storage may be overwritten by the 

dump program. If this is thought to be the case, use the method described 

below. 

Bytes 9-1 1 of the CCB associated with the channel program contain the 

addresses of the first CCW in the channel program. Bytes 13-1 5 of the same 

CCB contain the address of the next CCW, (only if no Channel Appendage 

Routine is used). Subtract eight from this address to obtain the address 

of the last CCW used. 

The figure below shows the format and contents of any CCW. 
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CHANNEL PROGRAM 



Command 


Data Address 


Flags 


00 


TP code 


Count 



32 



38 



40 



48 



63 



o 



FIELD 


DESCRIPTION 


Command 
Code 


Bits 0-7: 

Specify the operation to be performed. 
Consult device component manual 


Data Address 


Bits 8-31 : 

Specify the location of a byte in main storage. It is the first location 
referred to in the area designated by the CCW. 


Flags 


Bits 32-36: 

Specify the flag bits used in conjunction with the CCW. 

Bit 32- 

Chain-Data (CD) causes the address portion of the next CCW to be 
used with the current CCW. 

Bit 33-- 

Chain-Command (CO causes the command code and data address 
of the next CCW to be used. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 34- 

Suppress Length Indication (SLI) causes a possible incorrect length 
indication to be suppressed. The chain data flag (bit 32) takes 
precedence over this flag. 

Bit 35- 

Skip (SKIP) suppresses the transfer of information to real storage. 

Bit 36- 

Program Control Interruption (PCI) causes the channel to generate 

an interrupt when the CCW is fetched. 
Bit 37- 

UDAL bit. Set to 1 if I/O area crosses page boundary, that is, if the' 

I/O area is not confined to one page frame in real storage. 


Reserved 


Bits 38-39: 

(Must contain zeros)* 


TP 


Bits 40-47: Used by TP access methods. 


Count 


Bits 48-63: 

Specify the number of bytes in the operation 



*The transfer in channel command (TIC) is the one exception to this statement. 
Figure 4,34 Explanation of contents of the CCW 
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4.5/ 



Section 4, Chapter 6 

SURE R VI SO R CA L LS A problem program running in any partition fields gives control to the supervisor by 

issuing a supervisor call instruction. The SVC instruction contains a code that £ \ 

indicates its purpose. For example, SVC requests the supervisor to execute the 4 ;, 

channel program. Some SVCs are optional and cause program cancellation if the 
supervisor does not support the option requested. 

A complete list of DOS/VS SVC codes Wiih the associated macro instructions that 
generate the SVC is shown in Figure 4.35 parts 1,2 and 3. 

A detailed description of the SVCs can be found in DOS/VS Supervisor Logic. 






.J" 
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SVC 
Dec Hex 


Macro supported 


Function 








EXCP 


Execute Channel Program 


1 


1 


FETCH 


Fetch any phase 


2 


2 




Fetch a logical transient (B-transient) 


3 


3 




Force dequeue 


4 


4 


LOAD 


Load any phase 


5 


5 


MVCOM 


Modify supervisor communication region (if issued by 
MVCOM macro) Fetch any other physical transient (if 
issued by a physical transient) 


6 


6 


CANCEL 


Cancel a problem program or task 


7 


7 


WAIT 


Wait for a CCB or TECB 


8 


8 




Transfer control to the problem program from a logical 
transient (B-transient) 


9 


9 


LBRET 


Return to a logical transient (B-transient) from the 
problem program after an SVC 8 


10* 


A 


SETIME 


Set timer interval 


11 


B 




Return from a logical transient (B-transient) 


12 


C 




Reset switches in partition communication region. 


13 


D 




Set switches in partition communication region. 


14 


E 


EOJ 


Cancel job and go to job control for end of job step 


15 


F 


SYSIO 


Headqueue and execute channel program 


16* 


10 


STXIT(PC) 


Provide supervisor with linkage to user's PC routine 
for program check interrupts 


17* 


11 


EXIT(PC> 


Return from user's PC routine 


18* 


12 


STXIT(IT) 


Provide supervisor with linkage to user's IT routine 
for interval timer interrupts 


19* 


13 


EXIT(IT) 


Return from user's IT routine 


20* 


14 


STXIT(OC) 


Provide supervisor with linkage to user's OC routine for 
external or attention interrupts (operator comm.) 


21* 


15 


EXIT(OC) 


Return from user's OC routine 


22 


16 


SEIZE 


Seize/release system; enable/disable for external and 
I/O interrupts; set key in users PSW 


23* 


17 




Load phase header. Phase load address is stored at 
user's address 


24* 


18 


SETIME 


Set timer interval and provide supervisor with linkage 
to user's TECB, if any 


25* 


19 




Issue HALT I/O on a teleprocessing device, or HALT I/O 
on any device if issued by OLTEP. With multiprogram- 
ming dequeue an unstarted OLTEP I/O request to a 
shared device 


26* 


^fi 




Validate address limits 


27* 


IB 




Special HIO on teleprocessing devices 


28* 


1C 


EXIT(MR) 


Return from user's stacker select routine (MICR type 
devices only) 


29* 


1C 


WAITM 


Provide support for multiple wait macro WAITM 


30* 


IE 


QWAIT 


Wait for a QTAM element 


31* 


IF 


QPOST 


Post a QTAM element 



Section 4, Chapter 6 

SUPERVISOR CALLS 



optional 



Figure 4.29 Supervisor CaUs (Part 1 of 3) 
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SVC 
Dec 


Hex 


Macro Supported 


Function 


32 


20 




Reserved 


33 


21 




Reserved for COMRG macro 


34 


22 


GETIME 


Provides Time-of-Day and updates the DATE field 


35* 


23 


HOLD 


Hold a track for use by the requesting task only 


36* 


24 


FREE 


Free a track held by the task issuing the FREE 


37* 


25 


STXIT(AB) 


Provide supervisor with linkage to user's AB routine for 
abnormal termination of a task 


38* 


26 


ATTACH 


Initialize a subtask and establish its priority 


39* 


27 


DETACH 


Perform normal termination of a subtask. It includes 
calling the FREE routine to free any tracks held by the 
subtask 


40* 


28 


POST 


Inform the system of the termination of an event and 
ready any waiting tasks 


41* 


29 


DEQ 


Inform the system that a previously enqueued resource is 
now available 


42 


2A 


ENQ 


Prevent tasks from simultaneous manipulation of a shared 
data area (resource) 


43 


2B 




Reserved 


44* 


2C 




Provide supervisor support for external creation of unit 
check records by specific request 


45* 


2D 




Provide emulator interface 


46* 


2E 




Provide OLTEP with the facility to operate in supervisory 
state 


47* 


2F 


WAITF 


Provide support for multiple wait macro for MICR type 
devices 


48* 


30 




Fetch a CRT transient 


49 


31 




Used by VTAM 


50 


32 




Reserved for LIOCS error recovery 


51 


33 




Return phase header 


52* 
53 


34 
35 


TTIMER 


Return the remaining time interval, or cancel a time 

interval 

Used by VTAM 


54 


36 


FREEREAL 




55 
56* 


37 
38 


GETREAL 


Provide interf. between SDAID and PDAID initialization 
routine and page management routine, to create the 
PDAID alternate area of the SD area 
Reserved 


57* 


39 




Reserved 


58 


3A 




Provide interface between job control and the supervisor. 
Get real storage for real jobs 






optional 



Figure 4.29 



Supervisor Calls (Part 2 of 3) 
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SVC 
Dec Hex 


Macro supported 


Function 


59 


38 




Provide interface between EOJ and the supervisor. Reset 
the storage key for virtual jobs 


60 


3C 


GETADR 


Provide virtual address of location within 1/0 areas for 
ERP and CRT routines 


61* 


3D 


GETVIS 


Get storage in virtual partition 


62* 


3E 


FREEVIS 


Free storage in virtual partition 


63 


3F 


USE 


Use a resource 


64 


40 


RELEASE 


Release a resource 


65* 


41 


CDLOAD 


Load VSAM or core image phase 


66 


42 


RUNMODE 


Return mode in which program is running 


67* 


43 


PFIX 


Fix page(s) in real storage 


68* 


44 


PFREE 


Free page(s) in real storage 


69" 


45 


REALAD 


Return real address corresponding to a given virtual 
address 


70* 


46 


VIRTAD 


Return virtual address corresponding to a given real 
address 


71* 


47 


SETPFA 


Establish or terminate the linkage between the supervisor 
and a user page-fault appendage routine 


72* 


48 


GETCBUF- 








FREECBUF 


Get or free copy buffer for IDAL or tape ERP \ 


73* 


49 


SETAPP 


Allow linkage to channel and appendage routines 


74. 


4A 




Fix pagels) in real storage for restart 


75 


4B 


SECTVAL 


Calculate value of sector for RPS 


76 


4C 




Initiate RMS recording of an I/O error 


77 


4D 


TRANSCSW 


Returns the virtual address of a copied CCW 


82 - 


■84 




Reserved 


78* 


4E 


CHAP 


Change subtask priority 


79* 


4F 


SYNCH 


Pass control to synchronous exit 


80* 


50 


SETT 


Set the task timer 


81* 


51 


TESTT 


Test the task timer 


85 


55 


RELPAG 


Release contents of one or more pages 


86 


56 


FCEPGOUT 


Force a page-out for one or more pages 


87 


57 


PAGE IN 


Page in one or more pages 


88 


58 


TPIN 


Start TP balancing 


89 


59 


TPOUT 


Stop TP balancirtg 


90 


5A 


PUTACCT 


Provide interface with POWER /VS for additional 
account information (by user). 


91 


58 




Provide interface with POWER/VS for standard 
account information (DOS/VS). 


92* 


5C 


XECBTAB 


Define, delete, or check an entry in the Cross-Partition 
ECB table. 


93* 


5D 


XPOST 


Turn on traffic bit in cross-partition ECB and ready 
any waiting tasks. 


94* 


5e 


XWAIT 


WaitforanXECB. 


95* 


5F 


EXITAB 


Return from user's abnormal termination routine 


96* 


60 


EXITTT 


Return from task timer exit routine 


97* 


61 


STXIT TT 


Store address of task timer exit routine. 


98* 


62 


EXTRACT 


Extract a PUB2 table entry (**) 






MODCTB 


Modify a PUB2 table entry (*•) 
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•optional 

**For VSAM and 3800 support 
Figure 43S Supervisor Caiis \?mi 3 ^f 3) 
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PIB AND PIB2 The PIB (program Information Block) 



I' 

Real storage area is reserved in the supervisor for this information block by the 
MPS multiprogramming and/or NPARTS and AP (Asynchronous Processing) 
parameters of the SUPVR supervisor generation macro. Each entry in this block is 
16 bytes and contains status information about the program and, if AP is supported 
about the subtasks running in each partition supported by the supervisor. 

The first entry is reserved for the attention routine, this entry is called the 
Attention PIB (AR PIB). 

Other entries in the PIB belong to the problem programs and subtasks. The sum of 
all subtasks and problem program entries may not exceed 15. The maximum number 
of entries, including the attention PIB and AP (subtask) PIBs, is 16. 

For a supervisor that is not generated to support more than one partition there 
are two 16-byte entries. 



By examining the data recorded in the appropriate PIB entry, the status and location 
of the programs running in any partition can be estabHshed. Some of the more 
important data to be looked at in the PIB during the first analysis of a dump output 
are: 

• Byte 0, from which you can determine whether the program is waiting for 

- the LTA (Logical Transient Area), X'8 1 ' 

- the PTA (Physical Transient Area), X'85' 

- the IDRA (Independent Directory Read-in Area), X'6F' 
an I/O interrupt, X'82' 

- a page to be paged in, X'87' 

- a page to be paged in with QTAM active, X'8F' 

• Byte 4, X'80', which indicates that the job or task is running in virtual mode ^ -^ 

• The address of the program save area 

• The address of the system save area. 

Figure 4.36 (opposite) shows the format and describes the contents of an entry in 
the PIB. 

How to locate: 

Bytes X'5A' - X'5B' of the partition comregs contain the address of the first entry 
in this information block. Label PIBTAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB in a dump output. 
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Section 4, Chapter 7 

PIB AND PIB2 



PIBTAB 



Background PIB 



FGn 



PIB 



iiii 



FG1 



PIB 



Subtask PIB 



Subtask 



PIB 






Format of 
Attention PIB 






1 


2 3 


4 


5 6 7 


8 


9 10 


11 


12 


13 


14 


15 




Flag 


Cancel 


SYSLOG 


always 


Inactive = zero 


Switch 


Address of save 


X'07' 


BG 


Number Not 




Byte 


Code 


ID 

(AR) 


zero 


Active = Address 
of LTA save area 


Byte 


area or zero 
(Note 1) 




PIB 

assign 

flag 


user 
LUB 
index 


of BG 
pro- 
gram 


used 




(See Q) 








(Note 2) 


(See JFJ) 


(Note 2) 




(See© 




LUBs 







Note 1 : a. When LTA is inactive "LTA save area address. 

b. When LTA is active for Problem Programs, this address is exchanged with that in the Problem Program PIB. 

Note 2: When LTA is active for Logical Attention, bytes 9-11 are zero and bytes 5-7 contain the LTA save area address. 

Legend: A, B, C, D, E, Prefer to next part of ^his figure, which describes 
the meaning of each bit in a PIB entry. 

Format of any 
Probl. Program 
or Subtask PIB 







1 


2 3 


4 


5 6 7 


8 


9 10 11 


12 


13 


14 


15 




Flag 


Cancel 


SYSLOG 


DAT 


Address of Problem 


Gate 


Address of sys- 


PIB 


User 


Number 


Flag 




Byte 


Code 


ID 


flag 


Program save area or 
LTA save area 


ID 


tem save area 


assign 
flag 


LUB 
index 


of 
Pro- 


Byte 




(See (a)) 






(Seed)) 


(Note 3) 


(See 0) 




(See(§ 




gram 
LUBs 


(See|E]) 





Note 3: When the Logical Transient Area is active the save area address in the Problem Program PIB is exchanged with 
that in the Attention PIB. 

The number of Problem Program PIBs generated depends on the number of partitions specified during system generation. 
Subtask PIBs are generated only if AP= YES has been specified during system generation. 

The number of subtask PIBs generated depends on the number of partitions; it is 1 5 minus the number of partitions. 
A two-partition system, for example, has 1 3 subtask PIBs and a five-partition system has 10 subtask PIBs. 



Figure 4.36 Explanation of the contents of an entry in the PIB, 
part 1 of 3. 
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PIBAND PIB2 



FLAG BYTE (First byte in PIB) 

Flags which are always used: 

X'7r = Program is waiting for SVC58 

X'73' = Program is waiting because i/stem is seized 

X'75' = Program is waiting for copy block 

X'77' = Program is waiting for TF REE 

X'79' = Program is waiting for channel queue entry 

X'7B' = Program is waiting for CCW translation 

X'7F' = Program is waiting for XECB table 

X'80' = Program is not active 

X'81 ' = Program is SVC2-bound (waiting for the LTA to be released) 

X'82' = Program is SVC7-bound (vyaiting for an I/O interruption) 

X'83' = Program is ready to run 

X'85' = Program is SVCS-bound (waiting for the PTA to be released) 

X'86' = Initial selection of RAS (used only for RAS PIB flag) 

X'87' = Program is set to common-bound condition 

Flags used only under certain conditions: 

Flags with partition-dependent values: 

The table below shows the various possible values of these flags and the 
partition to which a given value refers, depending on the number of 
partitions. The meanings of the flags types A, B, C, and D are explained 
below the table. 



\1 



I 



Flag 



X'29' 
X'2B' 
X'2D' 
X'2F' 
X'31' 



~1 



B 

I 

X'SD' 
X*3F' 
X'4r 
X'43' 
X'45' 



C I 



r 



X'4B' 
X'4D' 
X'4F' 
X'5r 
X'53' 



I I Partition referenced ' 

I NPARTS= I 

I 2 3 4 5 I 



X'59' 
X'5B' 
X5D' 
X'5F' 
X'61' 



I BG 
I F1 



BG 
F2 
F1 



BG 
F3 
F2 
F1 



BG 
F4 
F3 
F2 
F1 



~Jv 






Flag A is used only if AP=YES and VSAM=YES. The codes are used to 
gate the CDLOAD routine for tasks running in one partition. 

Flag B is used only if AP=YES and GETVIS=YES. The codes are used to 
gate the GETVIS routine for tasks running in one partition. 

Flag C is used only if AP=YES and PFIX=YES. The codes are used by 
the PFIX routine to set a partition PFIX-bound. 

Flag D is used only if PARTS>1 . The codes are used by the load 
leveller to deactivate a partition. 

Flags with partition-independent values: 

The following flags are used only if NPARTS>1 : 
X'6A' = Program is SVC35-bound 1 .cToi^uiri- 

X'6B' = Program is SVC35-bound ^ only if TRKHLD-n 
X'6D' = Program is waiting for the next freed page frame. 

The following flags are used only if AP=YES: 
X'67' = Program is SVC38-bound 
X'69' = Program is SVC41 /42-bound 

The following flag is used only if CBF=n: 

X'7D' = Program is waiting for free console buffer table entry 

The following flag is used only if TP=QTAM: 
X'8B' = Task in QTAM wait 

The following flag is used only if IDRA=YES or D0C=1 25D/3277: 
X'6F' = Program is IDRA-bound 

The flags X'37', X'39', and X'3B' are used if TP=VTAM to gate the 
SVC53 routine. 



Figure 4.36 Explanation of the contents of an entry in the PIB, part 2 of 3 
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[T] PIB DAT Flag 

X'01' = Return re-enterable supervisor routine 
X'02' = Return to gated supervisor routine 
X'04' = Move CCB at dispatching time 
X'08' = Service delayed external interrupt 
X'10' = Deactivation of this task is being delayed. 
X'20' = Service delayed OC request 
X'40' = Task has seized the system 
X'80' = Program is running in virtual mode 

[c] Gate Identifier 

X'71 ' = Gating of SVC58 required 
X'53' = Gating of SVC41 /42 required 

The flags are only used if the PIB DAT Flag is X'03', that is, the first two 
flags are on (See [b] ). 

fp] PIB Assign Flag 

X'80' = SYSRES DASD file protect inhibited (allow write operation on SYSRES) 

X'40' = Channel appendage exit allowed (BTAM) 

X'20' = Cancel in progress (used in terminator function) 

X'10' = Cancel control (set on a foreground cancel) 

X'08' = Hold foreground assignments 

X'07' = Attention PIB 



JE^ Problem Program PIB Flag (Last byte in PIB) 



BitO 
Bit 1 
Bit 2 
Bit 3 
Bit 4 
Bit 5 
Bite 
Bit 7 



1= Batched job in foreground (always on when tested) 
1= Cancel in LTA and device not assigned 
1=/&onSYSINif DASD 
1= Partition in stopped state 
1= Fetch EOJ monitor 
1= Task is canceled 
1= Subtask(s) attached 
1= in AB routine 



to Attention PIB Switch Byte 



BitO 
Bit 1 
Bit 2 
Bits 
Bit 4 
Bit 5 
Bite 
Bit 7 



Reserved 

Fetch Physical Attention Routine SSABERRZ 

1= Delay cancelation 

1= Emergency cancel request 

1= Reserved 

Command available 

1= Fetch Logical Attention Routine (SSBATTNA) 

1= External Interrupt request 
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Figure 4.36 Explanation of the contents of an entry in the PIB, part 3 of 3 
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Section 4, Chapter 7 

PIB AND PIB2 PIB2 (Program Information Block Extension) 



As the name of this block impUes, it is an extension of the PIB and is of identical 
size, being generated with the PIB during system generation. Data recorded in each 
16-bytes entry supplements the data recorded in the PIB. 

By examining the contents of bytes and 1 of the appropriate problem program 
PIB2 entry, the address of the associated partition communication region can be 
established. 



How to locate: 

Bytes X'7C' — X'7D' of the partition comregs contain the address of the first entry 
in this information block. Label PIB2TAB in the supervisor listing identifies the 
address of the first byte of this information block. 

Appendix G shows an example of locating the PIB2 in a dump. 
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PIB2TAB 



Attention 


PIB 


Background PIB 


FGn 


PIB 


======H 


FG2 


PIB 


FG1 


PIB 


Subtask 


PIB 


L==^ 


Subtask 


PIB 
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PIB AND PIB2 



Format of any 
PIB extension 
entry 



1 


2 3 


4 5 6 7 


8 9 10 11 


12 13 


14 


15 


1 6-bit 














Address of com- 


System 


Interrupt 


Address of termination ECB 


Program 


un- 


Flag 


munication 


LUB index 


Information 


if any, otherwise zeros 


Interrupt 


used 


Byte 


region of 








Key (PIK) 




(See 


partition 












B 


(Notel) 




(See table [aJ below) 








be ow) 



Note 1: Always BG communications region in Attention and Background PIB extension. Appropriate communication 
region in other PIB extensions when a multiprogram system has been generated. To place this address in a 
register, the instruction ICM should be used. For each PIB Table entry, 
an entry exists in the PIB Table Extension. 



B 



ILC (Instruction Length Code) is in bits 5 and 6; other bits are zeros. 







Type of interruption 


Contents of PIB Extension Bytes 


4 


5 


6 1 7 


SVC 
PC 

I/O 


00 
00 
00 


ILC* 
ILC* 
00 


Interruption Code 
Interruption Code 
I/O Address 



Byte 14 


Byte 1 5 




Bit 1 


Not used 




Bit 2 


1 = Task owns CRT 


Not used 


Bit 3 


VTAM automatic close in process 




Bit 4 


Not used 




Bits 


1 =SVC Screening active 




Bite 


Not used 




Bit 7 


XECB: Task has issued SVC 92, 
93, or 94 



Figure 4.37 Explanation of the contents of an entry in the PIB2 
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CANCEL CODES 



Byte 1 of the PIB contains a cancel code that is stored by the supervisor in the 
event of program cancellation. Normally a message is printed on SYSLOG and/ or 
SYSLST that informs the operator about the reason for the cancellation, for 
example: 

BG 0S04I ILLEGAL SVC - HEX LOCATION 007884 - SVC CODE 14 

The cancel code (stored in byte 1 of the associated partition PIB) should be 
examined also in the event of a system malfunction such as a LOOP or WAIT STATE 
that prevents the system from issuing an error message. 

Figure 4.38 (below) shows a Ust of all the cancel codes and their message prefixes. 

All these cancel codes cancel the program, task, or subtask when they occur. If 
multitasking is being used and a main task is canceled, all of the subtasks attached 
are detached and canceled as a result of the main task being canceled. If a dump 
option was specified at system generation time or by job control, the contents of 
the supervisor and the partition in which the cancel condition occurred is printed 
on SYSLST. 



Cancel 
Code (hex) 


Message 
Code 




Descriptive part of Message 

or Condition 


00 




Default value for all cases not mentioned below 


10 




Normal EOJ 


11 


0V071 


No channel program translation for unsupported device 


12 


0V06I 


Insufficient buffer space for channel program translation 


13 


0V05I 


CCW with count greater than 32K 


14 


0V04I 


Page pool too small 


15 


0V02I 


Page fault in disabled program 


16 


0V01I 


Page fault in MICR stacker select or PHO routine 


17 


0S02I 


Program request (Same as 23 but causes dump because subtasks 
were attached when maintask issued CANCEL macro) 


18 




Eliminates cancel message when maintask issues DUMP macro 
with subtasks attached 


19 


0P74I 


I/O operator option 


1A 


0P73I 


I/O error 


IB 


0P82I 


Channel failure 


1C 


0S141 


CANCEL ALL macro 


ID 


0S12I 


Main task termination 


IE 


0S13I 


Unknown ENQ requestor 



Figure 4.38 DOS/VS Cancel Codes and Messages, part 1 of 2. 



V. 



y 



4,98 Debugging for Programmers, part 2 



Cancel 


Message 


Descriptive part of Message 


Code (hex) 


Code 


or Condition 


IF 


0P81I 


CPU failure 


20 


0S03I or 
0S11I 


Program check 


21 


0S04I or 
0S09I 


Illegal SVC 


22 


0S05I or 
0S061 


Phase not found 


23 


0S02I 


Program request 


24 


0S01I 


Operator intervention 


25 


0P77I 


Invalid address 


26* 


0P71I 


SYSxxx not assigned (unassigned LUB code) 


27 


0P701 


Undefined logical unit 


28 




QTAM cancel in progress 


29 


0S15I 


No relocating loader support (Fetch or load request for 
relocatable phase while supervisor does not support relocating 
load) 


2A 


0P84I 


I/O error on page data set 


2B 


0V10I 


I/O error during fetch (irrecoverable I/O error during fetch) 


2C 


0V09I 


Illegal parameter passed by PHO routine 


2D 


0P881 


Program cannot be executed/restarted due to failing storage block 


2E 


0S16I 


Invalid resource request (possible deadlock) 


2F 


0V03I 


More than 255 PFIX requests for 1 page 


30 


0P721 


Reading past /& statement (on SYSRDR or SYSIPT) 


31 


0P751 


I/O error queue overflow (error queue over-flow) 


32 


0P76I 


Invalid DASD address 


33 


0P79I 


No long seek (disk) 


34 




Reserved 


35 


0P85I 


Job control open failure 


36 


0V08I 


Page fault in I/O appendage routine 


37 




Reserved 


38 


0V11I 


Wrong privately translated CCW 


39 




Reserved 


FF 


0P78I 


Unrecognized cancel code 




0P83A** 


Supervisor catalog failure 




0P87A** 


IPL failure 
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CANCEL CODES 



Figure 4.38 DOS/VS Cancel Codes and Messages, part 2 of 2. 

* If the CCB is not available, the logical unit is SYSxxx. 

** The cancel code is not significant in case of a supervisor catalog or IPL failure, because 
the system is placed in the wait state without any further processing by the Terminator. 

Note: In addition to recognizing ttie cancel codes above, the Terminator also recognizes the 
same codes with the X'80' bit on (cancel occurred in L TA). The X'80' bit is tested by 
$^BEOJ and subsequently reset 
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Section 4, Chapter 9 

GENERAL PUR POSE The following paragraphs describe the general usage of registers 0, 1, 13, 14, and 15 

R EG ISTE R USAG E by IOCS, but the description is not meant to be all-inclusive. /f 



Registers and 1: Logical IOCS macros, the supervisor macros, and other IBM- 
supplied macros use these registers to pass parameters. Therefore, these registers 
may be used without restriction only for immediate computations, where the 
contents of the register are no longer needed after the computation. If you use them, 
however, you must either save their contents yourself (and reload them later) of 
finish with them before IOCS uses these registers. 

Register 13: Control program subroutines, including logical IOCS, use this register 
as a pointer to a 72-byte doubleword-aligned save area. When using the CALL, 
SAVE, or RETURN macros, you can set the address of the save area at the beginning 
of each program phase, and leave it unchanged thereafter. However, when sharing 
a reenterable (read only) logic module among tasks, each time that module is 
entered by another task, register 13 must contain the address of another 72-byte 
save area to be used by that logic module. 

Registers 14 and 15: Logical IOCS uses these two registers for linkage. Register 14 
contains the return address (to the program) from DTP routines, called programs, 
and your subroutines. Register 1 5 contains the entry point into these routines, and 
is used as a base register by the OPEN (R), CLOSE (R), and certain DTP macros. 
IOCS does not save the contents of these registers before using them. If you use 
these registers you either save their contents yourself (and reload them later) or 
finish with them before IOCS uses them. 



Registers for Your Use 

Registers 2-12 are available for general usage. There are, however, a few restrictions. 

The assembler instruction for translate and test (TRT) makes special use of 
register 2. It is your responsibility to save the contents of this register before 
executing the TRT instruction if register 2 contains valuable information (such as 
pointers or counters) for later use in your program. After the TRT instruction has 
been executed, you can then restore the contents of register 2 from the save area. 

If an ISMOD logic module precedes a USING statement or follows your program, 
the use of registers 2-12 remains unrestricted even at assembly time. However, if 
the ISMOD logic module lies within the problem program, you should issue the 
same USING statement (which was issued before the logic module) directly follow- 
ing the logic module. This action is necessary because the ISMOD logic module 
uses registers 1,2, and 3 as base registers, and the ISMOD CORDATA logic module 
uses registers 1 , 2, 3, and 5 as base registers. Each time either module is assembled, 
these registers are dropped. 
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Section 4, Chapter 9 

Register usage by JOB ACCOUNTING GENERAL PURPOSE 

REGISTER USAGE 

(The Job Accounting option is discussed in Appendix H. 

The system passes registers 1 1-15 to the user's I/O routine ($JOBACCT). These 
registers contain the following information: 

• Register 1 1 : Length of the job accounting table. Each table may vary in 
length according to the number of SIO counts specified at system generation 
time. 

• Register 12: Base register for $JOBACCT (this eliminates the need for the 
user to load the base register) 

• Rfigister 13: Address of the user save area 

• Register 14: Link register ($JOBACCT must exit via BR 14 to return to 
job control) 

• Register 15: Address of the partition's job accounting table. 

Because some of the job step information is cleared in the step-to-step transition, 
job control calls $JOBACCT at the end of each step. If $JOBACCT does not save 
or accumulate this information, it is lost. 
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GENERAL PURPOSE 
REGISTER USAGE 



Linkage Registers 

To standardize branching and linking, registers are assigned specific roles (Figure 
4.39). Registers 0, 1, 13, 14, and 15, are known as the linkage registers. Before a 
branch to another routine, the calling program is responsible for the following 
calling sequence: 
1 . Loading register 13 with the address of a register save area in the program 

that the called program is to use 

Loading register 14 with the address to which the called program will return 

control 

Loading register 15 with the address from which the called program will 

take control 

Loading registers and 1 with parameters, or loading register 1 with the 

address of a parameter list. (Although permissible, it is not normal to load 

register with parameters). 



2. 



3. 



4. 






Register 
Number 


Register Name 


Contents 





Parameter register 


Parameters to be passed to tlie called 
program. 


1 


Parameter register 

or 

Parameter list 
register 


Parameters to be passed to the called 
program. 

Address of a parameter list to be 
passed to either the control program 
or a user's subprogram. 


13 


Save area register 


Address of the register save area to be 
used by the called program. 


14 


Return register 


Address of the location in the calling 
program to which control should be 
returned after execution of the 
called program. 


15 


Entry point register 


Address of the entry point in the 
called program. 



Figure 4.39 Linkage Registers 

After execution of the caUing sequence, the following should occur as a result of 
called program execution: 

1 . The contents of registers 2 through 14, and the program mask are unchanged. 

2. The contents of registers 0, 1 and 15, the contents of the floating point 
registers, and the condition mode may be changed. 

3. The parameter Hst addresses contain the results obtained by the execution 
of the called program. 



V.^-^^ 



4. 1 02 Debugging for Programmers, part 2 



Section 4, Chapter 10 

When support is provided during system generation for user exit routines (other TAB LES R EQU I R E D BY 

thatn VSAM exit routines), an area is reserved in the supervisor for one or more of USER EXIT ROUTINES 

the following tables: 

• Interval timer (IT) 

• Abnormal termination (AB) 

• Task timer (TT) 

• Page fault handling overlap (PHO) 

• Program check (PC) 

• Operator communication (OC). 

Entries in the table are generated from the STXIT macro issued by the problem 
program, and the number of entries depends on the number of partitions for 
which the system has been generated. 

The number of entries for the PC and AB tables is increased by the number of 
subtasks allowed on a system generated for use with multitasking. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Interval Timer Support (IT) 

4 

This parameter generates programming support for the hardware interval timer \ 

feature, which is used to time-stamp the system. It enables a problem program to 
set a time interval (via the SETIME macro). 

By using the STXIT, EXIT, and TECB macros, a specific routine within the problem 
program or task is entered when this time interval elapses. 

How to locate the IT option table 

Bytes X'66'-X'67' of the partition communication regions contain the address of 
the IT Option Table. Label ITTAB identifies the first byte of the table. 



ITTAB 



See 
Note 



BG 



Fn 



< 



\. 



n 



F1 



Subtask 



Subtask 



Subtask 



34 



TECB 



Save Area 



/ 



Address 

.1 



1 1 r 

Compl. of TECB 



Save Area , 



Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



/ 



\ 



/ 



\ 



\ 



/ 






\ 


Bytes 0-3: 


No TECB or STXIT 








issued : 


zero 






TECB issued : 


Address of the tinner event control block 






STXIT issued 


Address of user interval timer routine 






STXIT issued and 








user routine is 








already in use : 


Complement of the user interval timer routine 




Bytes 4-7: 


No TECB or STXIT 








issued 


zero 






TECB issued 


Complement of the TECB address 






STXIT issued 


Address of the user save area 





'v..,..,=/ 



Note: One table entry is built for each partition and an IT Request table is also built. 

With multiple timer and asynchronous processing supported, the table always 
comprises 15 entries; the subtask entries occupy the higher address locations 
in the table. 



Figure 4.40 Explanation of the contents of the IT option table. 



4. 1 04 Debugging for Programmers, par t 2 



Interval Timer Request Table 

This table is generated only for systems supporting the interval timer option 
(IT= YES). It is used in conjunction with the IT option table described in 
Figure 4,40. 

The number of entries is one more than the number of partitions supported, but 
with multiple timer and asynchronous processing supported, the table always 
comprises 16 entries. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



How to locate the IT request table 

Bytes X'50'-X'53' of the System Communication region (SYSCOM) contain the 
address of the IT Request Table. Label ITREQ identifies the first byte of the 
table. 



ITREQ 



Task 
Identifier 



Time Interval 



/ 



\ 



\ 



/ 



\ 



00 FF 00 00 00 



/ 



/ 



/ 



/ 



Note: This table is only used when a 
timer interrupt occurs white an 
interrupt from another partition or 
tasl< is pending. See SVC 24 in 
DOS/VS Supervisor. 



/ 



\ 



\ 



\ 



\ 



\ 



Byte : PIK or TIK (X'10-X'FO') of the program or task that issued the 

SETIME macro. If the entry is not used or is the last entry, 
byte contains X'OO'. 



Bytes 1-4: Time interval that will elapse between the occurrence of the currently 
pending interrupt in SYSTIMER and the occurence of the interrupt 
itself. The entries are in ascending order of magnitude, that is, the 
smallest interval appears first. If the entry is not used or is the last 
entry, bytes 1—4 contain the highest interval possible {X'FFOOOOOO'). 

The interval corresponding to the currently pending interrupt is in 
SYSTIMER (address X'50') and the key of the respective program 
ortask is inTWTIMS. 



Figure 4,41 Explanation of the contents of the IT option request table. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Abnormal termination support (AB) 

Abnormal termination exits are available for main tasks and/or subtasks, allowing 
you to gain control before an abnormal condition removes the task from the 
system. For example, in the abnormal termination routine, you can close your 
files. This function is provided by the AB operand of the STXIT macro. See 
Supervisor and I/O Macros for detailed information on the format and use of the 
STXIT macro. 






ABTAB 



BG 



Fn 



See 
Note "^ 



V- 



F1 



Subtask 



Subtask 



Subtask 



How to locate: 

Bytes X'54'-X'57' of the System Communication region (SYSCOM) contain the 
address of the AB Option Table. Label ABTAB identifies the first byte of the 
table. 



3 4 



Flags 



AB 
Routine Address 



Can- 
cel 
Code 



1 1 

Save Area Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 




\ 


Byte 0: 


Bit 


Zero 




Bit 1 


1 = timer interrupt occurred during processing of 
abnormal termination routine. 




Bits 2-7 


Reserved 


Bytes 1-3: 


No STXIT issued 
STXIT issued and 
rtnaddr parameter 


Zero 




passed 


Address of entry point of user's abnormal termination 
routine. If AP (Asynchronous Processing) is supported 
the maintask and subtasks may have the same or 
different AB routine. When a subtask is ATTACHed 
after a STXIT AB macro has been issued by the 
maintask, the subtask will receive the AB routine 
address specified by the maintask only if the 
ATTACH macro for that subtask has the ABSAVE 
parameter specified. The subtask can override this 
by ussuing its own STXIT AB macro. 


Byte 4: 


STXT issued and 
abnormal termina- 
tion routine in 






progress 


: Original cancel code (see Figure 4.38) 




All other 






conditions 


Zero 


Bytes 5-7: 


No STXIT issued 
or no save area 






parameter passed 


Zero 




STXIT issued and 






save area para- 






meter passed 


Address of a 72 -byte save area used by the supervisor 
to store the interrupt status information and the 
contents of the general registers. (See Chapter 12.) 



X_^' 



Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 



4. 106 Debugging for Programmers, part 2 



Figure 4.42 Explanation of the contents of the AB option table. 






Task Timer Support (TT) 

The task timer permits a task to specify that it wants to receive control via an 
exit routine after it has executed for a specified length of time. The time value 
specified is decremented only when the task is executing, and the exit routine 
is entered when the time value becomes zero. The task timer can be used only by 
the main task in the partition for which task timer support was generated. 

The address of the exit routine, and a save area for the interrupted environment, 
must be provided with the aid of the STXIT macro. The time interval is specified 
with the aid of the SETT macro, and can be tested or canceled by the TESTT 
macro. The EXIT macro is used to return from the task timer exit routine. 



Section 4, Chapter 10 

TABLES REQUIRED BY 
USER EXIT ROUTINES 



How to locate: 

ATTAB (Bytes X'B0'-X'B3') in the system communication region (SYSCOM) 
contains a pointer to TTTAB. 

TTOWNR (Bytes X'BE'-X'BF') in SYSCOM contains the key (PIK) of the 
partition for which task timer support was generated. 



TTTAB 



34 



78 



— I 1 1 — 

Exit routine 

address 

— I 1 1 — 



-I 1 r 

Save area 
address 



-1 i 1 1 1 1 r 

Tasl< timer interval 
J 1 I ! 1 1 L 



15 



/ 



Bytes 0-3; No STXIT issued 
STXIT issued 

STXIT issued and 
user's routine 
already in use 

Bytes 4-7: No STXIT issued 
STXIT issued 

Bytes 8-1 5: No SETT issued 
SETT issued 



Zero 

Address of entry point of user's task timer 
exit routine 



Complement of the task timer routine address 

Zero 

Address of user's save area 

Zero or negative 

Time remaining in the specifed interval. The time 
is stored in microseconds in bits 0-51. 
Bits 52-63 are ignored. 



This table exists only if TTIME=YES was specified during system generation. 
Explanation of the contents of the task timer option table 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Page Fault Handling Overlap Support (PHO) 

This option enables a user routine to continue processing during the time a page 
fault, occurring in the same task, is being handled, PHO=YES in the SUPVR 
supervisor generation macro reserves an area in the supervisor for the PHO option 
table. Entries are made in this table when the user program issues a SETPFA macro 
instruction. The SETPFA macro instruction is described in DOS /VS Supervisor 
and I/O Macros. If asynchronous processing (AP) is not supported, one entry is 
generated in the table for each partition supported by the system (NPARTS). If 
AP is supported, 15 entries are generated. 



.r 

i 



V 
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How to locate: 

Label PFATAB in the supervisor listing identifies the first byte of this table. 



TABLES REQUIRED BY 
USER EXIT ROUTINES 



r 



See 
Note 



< 



o 



PFATAB 



BG 



Fn 



F1 



Subtask 



Subtask 



Subtask 



3 4 



PHO 
Routine Address 



/ 






Page Fault Information 



Flag Byte 



\ 



\ 



\ 



/ 



/ 



\ 



\ 



/ 



\ 



\ 



\ 



/ 



\ 



SETPFA issued 



Byte : Bit : 1= A page fault from the task is in the Page Queue Table. 

Bit 1 : 1 = A page fault occuring in a supervisor service of the task is 

queued in the Page Queue Table. 

Bits 2-7: Unused. 

Bytes 1-3; Address of the user's page fault appendage routine. 

Bytes 4-7: Page fault information (for detailed layout see Page Queue Table). 

This information is stored here only when a page fault occurs in a supervisor 
service working for the task, while another page fault is queued for the 
task in the Page Queue Table; otherwise, zeros. 

NO SETPFA issued 



Bytes 0-7: Zeros. 



Note: One table entry is generated for each partition supported. With asynchronous processing 
support, the table always comprises 15 entries; the subtask entries occupy the higher 
address locations in the table. 

PFA TAB is only built ifPHO=YES was specified in the SUPVR macro at supervisor 
generation. 
Figure 4.43 Explanation of the contents of an entry in the PHO option table. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



Program check support (PC) 

Program check (PC) support generates a PC table within the supervisor (see the 
Figure below). The address of a user program check routine is placed in the table 
via the STXIT macro issued by the problem program. If the STXIT PC Unkage is 
established and a program check occurs within this program, the supervisor gives 
control to the user's routine instead of canceling the job being run in this partition. 
The support is extremely advantageous when using LIOCS. (For example, files can 
be closed before job termination.) If a program check occurs in a routine being 
executed from the logical transient area (LTA), only the task associated with that 
routine is abnormally terminated. 



>f 



■\ 



X.^j' 



In a multitasking environment each subtask and main task may have its own PC 
routine. A PC routine can be shared by more than one task within a partition. This 
can be done issuing a STXIT macro in each task with the same routine address but 
with separate save areas. To successfully share the same PC routine, it must be 
reenterable (capable of being used concurrently by two or more tasks). 



How to locate: 

Bytes X'64'-X'65' of the partition communication regions contain the address of 
the PC Option Table. Label PCTAB identifies the first byte of the table. 



PCTAB 



BG 



Fn 



See 
Note's 



f2 



F1 



Subtask 



V 



Subtask 



Subtask 



PC Routine Address 



1 1 r 

Save Area Address 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



/ 



\ 



\. 



Bytes 0-3: 


No STXIT issued 


: Zero. 




STXIT issued 


Address of the user Program Check Routine. 




STXIT issued and 






the user routine 






is already in use 


: Complement of user Program Check Routine address. 


Bytes 4-7: 


No STXIT issued 


Zero. 




STXIT issued 


Address of the user Save Area. 



Note: In a supervisor without multiprogramming support, there is only one entry (BG) in each 
generated table. With multiprogramming support, there is one entry for each partition 
supported. 

With asynchronous processing support, each generated table always comprises 15 entries; 
the subtask entries occupy the higher address locations in the table. 

Figure 4.44 Explanation of the contents of an entry in the PC option table. 
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Operator communications support (OC) 

Operator Communications (OC) refers to the processing of an external interrupt 
by a problem program. In a multitasking environment, only the main task can 
communicate via the OC linkage. By specifying OC=YES, a table (OC option table) 
is generated within the supervisor (see Figure below). When the problem program 
issues the STXIT macro, the address of its external interrupt routine is moved to the 
OC option table. The user's routine is terminated by issuing the EXIT macro. When 
OC=YES is specified, support is available to all partitions. 
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TABLES REQUIRED BY 
USER EXIT ROUTINES 



How to locate: 

Bytes X'68'— X'69' of the partition communication regions contain the address of 
the OC Option Table. Label OCTAB identifies the first byte of the table. 



OCTAB 



r 



See I 

Note's 



BG 



Fn 



F1 



Subtask 



Subtask 



Subtask 







1 1 1 — 

OC Routine Address 

\ I I — 



1 1 , 

Save Area Address 

I I I 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



\ 



/ 




\ 


Bytes 0-3: 


No STXIT issued 


Zero. 




STXIT issued : 


Address of the user Operator Communication 
Routine. 




STXIT issued and 






the user routine 






is already in use : 


Complement of the user Operator Communication 
Routine 


Bytes 4-7: 


No STXIT issued 


Zero. 




STXIT issued : 


Address of the user Save Area. 



Note: fn a supervisor without multiprogramming support, ttiere is only one entry (BG) in each 
generated table. 

With multiprogramming support, there is one entry for each partition supported. 
With asynchronous processing support, each generated table always comprises 
15 entries; the subtask entries occupy the higher address locations in the table. 

Figure 4.45 Explanation of the contents of an entry in the OC option table. 
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SAVEAREAS 



Partition Save Areas and Label Save Areas 

Each partition contains a save area for program name, old program status word, 
and registers. 

Following the partition save area, each partition contains a label area for label 
processing if the LBLTYP statement is used. Both areas are at the low end of the 
partition. 

Save area length =88 (dec) bytes or, if the floating point feature is supported, 
120 (dec) bytes (FP=YES specified in the CONFG system generation macro). 

Label area length is determined by the system according to the LBLTYP card 
specification: 

• TAPE (standard tape labels) = 80 bytes 

• NSD (nn) (nonsequential disk) = 84 bytes + 20 bytes per extent statement 

• Omitted = 0. 

Figure 4.47 (opposite) illustrates the location of the partition and label save areas 
in virtual storage for a system supporting multiprogramming. The figure below 
shows an example of a background program partition, save area as it is printed in a 
system dump. The programmers remarks on the figure indicate how the programmer 
used the save area during offline debugging. 







V-.-^ 



Figure 4.46 An example of a system dump output showing the partition save area. 

The programmer's remarks on the dump show areas of immediate interest during 
offline debugging. 



How to locate: 

The addresses of the partition save areas are stored in the problem program PIB, 
described in Chapter 7 in this Section. 
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SPVR < 



y 



BG 



< 



> 



Supervisor Area 
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Background program area. 
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Foreground program area. 



FG 



< 



K. 




Other foreground program save areas, 



label save areas, 



and program areas have 
similar layouts. 
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f SAVE AREAS 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 

9 through 8 (64 bytes) 



Length of Label Area (2 bytes) 
See note 4 



Reserved (6 bytes) See note 2 



Floating Point Registers 
32 bytes 
(See note 3) 



Program name (8 bytes) 



Return PSW (8 bytes) 



General Registers 9 through 8 
64 bytes 



Length of Label Area (2 bytes) 
I See note 4 



Reserved (6 bytes) See note 2. 



Floating Point Registers 
32 bytes 
See note 3. 



Note 1 : Length of the label area depends on the amount of storage specified by LBL TYP statement: 

a. For standard tape labels (any number) -80 bytes. 

b. For sequential DASD and DTFPH MOUNTED SINGLE -0 bytes. 

c. For DTFIS, DTFDA, and DTFPH MOUNTED ALL -84 bytes plus 20 bytes per extent. 

Note 2: Job start time, for time stamp, is stored in last 4 bytes of this area. 

Note 3: Floating point register save area is required only when floating point feature is specified at 
supervisor generation, and omitted in a 1 -partition (non-MPS) environment. 

Note 4: Only nonzero if a // LBL TYP statemen t read before the curren t job step. Otherwise, 
reserved by the linkage editor, but not entered in these bytes. 



Figure 4,47 Organization of partition and label save areas 
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SAVE AREAS 



ABSAVE area 

In all abnormal termination conditions where an exit is taken to an abnormal 
termination routine specified and written by the user, the register values are stored 
in the ABSAVE save area before the appropriate error code is stored in the low- 
order byte of register 0. To have this value available when looking at a storage 
dump you should store (STC or ST) register in another save area upon entry into 
the abnormal termination routine. You will find that the SVC code shown in the 
"0S04I ILLEGAL SVC— ..." message along with the error codes in register 
will be helpful in tracing program errors. Each user exit routine must have its own 
save area in order to preserve the contents of the 16 general registers and interrupt 
status information at the time the exit routine is entered. The address of the save 
area is specified in the STXIT macro and is contained in the appropriate option 
table. 

Figure 4.48 (opposite) illustrates the format and contents of the Interrupt Status 
Information (the first 8 bytes of the save area). Details about the STXIT macro 
can be found in DOS /VS Supervisor and I/O Macros, and details about the option 
tables in the DOS/ VS Supervisor Logic. 
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STXIT 



fiT ^ 


PC 


AB 


1 oc f- 
Ltt J 



Exit Routine 




r 1 

Save area 
address 



General 

Registers 

0-15 



X'48' byte save area 
for user exit routines 
IT, PC, AB, OC, TT. 



Section 4, Chapter 11 

SAVE AREAS 



Reserved 


Key 


1 
MWP 


1 Interruption Code 


ILC 


CC 


Program 
IVlark 


Instruction Address 



Always 
X'OO' 



Bit 12 is always set to 1 

Bit 1 3 if set to 1 , enables machine check interrupt 
Bit 14 if set to 1 , indicates CPU wait state. 
Bit 15 if set to 1 , indicates CPU in problem state 
if set to 0, indicates CPU in supervisor state 



Interrupt codes j 
for PC: ■% 



interrupt code 
for IT: 

Interrupt codes 
for OC: 

Figure 4.48 



x'or 

X'02' 
X'03' 
X'04' 
X'05' 
X'06' 
X'07' 
X'08' 
X'09' 
X'OA' 
X'OB' 
X'OC 
X'OD' 
X'OE' 
X'OF' 
X'10' 

x'lr 

X'12' 
X'13' 
X'40' 
X'8X' 

X'80' 

X'40' 



Cause of Program 
Interrupt 

00000001 Operation 

00000010 Privileged operation 

0000001 1 Execute 

00000100 Protection 

00000101 Addressing 

00000110 Specification 

000001 1 1 Data 

00001000 Fixed point overflow 

00001001 Fixed point divide 

00001010 Decimal overflow 

00001011 Decimal divide 

00001100 Exponent overflow 

00001101 Exponent underflow 

00001110 Significance 

00001 1 1 1 Floating-point divide 

00010000 Segment translation 

00010001 Page translation 

00010010 Translation specification exception 

00010011 Special operation exception 
01000000 IVlonitor call 

1 xxxxxxx PER event, where x = code 

for cause of program 

10000000 Timer check. For example, a 

PER + a data exception 

01000000 External = X'87' (10000111). 



The format and contents of the user exit routine save area and 
interrupt status information. 
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SAVE AREAS System Save Areas (for system tasks) 



There are occasions when task information must be saved by the supervisor (f ; 

service routines. For example, page faults may occur when supervisor services are \..y 

executed under control of user PIBs. Because the user partition save area is occupied 
during this time, an additional system save area for each user task is provided. 

The information saves is contained in a 72-byte (dec) field, and includes the return 
PSW and 16 general purpose registers belonging to the interrupt supervisor task. 
The registers are stored in numerical sequence beginning with GR9. The save areas 
for all tasks (maximum of 1 5), are within the supervisor area. The address of each 
user task save area is recorded in the program information block. (Refer to Chapter 
7 in this Section.) 

Immediately following each save area is an area reserved for the CCW/TCB (Channel 
Command Word/Translation Control Block), the format and contents of which is 
described in Chapter 13 in this Section. The addresses of system task save areas 
are contained in the system communication region, refer to Chapter 2 in this 
Section. 
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Save Areas for the Job Accounting option 

If the JALIOCS parameter is specified in the FOPT supervisor generation macro, 
two save areas are reserved in the supervisor. 
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SAVE AREAS 



JALIOCS= 



NO 

(s,l) 






NO indicates that no special LIOCS support is required. Specification of (s, 1) 
indicates that a user save area and a label area are to be reserved. 

S is the decimal number of bytes to be reserved for the user save area (located in 
the supervisor). This save area may be used to save DTF information or for any 
other purpose desired by the user. The system does not access this area. (The 
address of the save area is available in register 13 when $JOBACCT is called.) 
The valid range of s is 0-1024, with a default of 16. 1 is the decimal number of 
bytes needed for a label area. This label area replaces the one normally used by 
LIOCS label processing. It is required when $JOBACCT uses LIOCS for such 
things as standard tape labels, DTFDA, and DTFPH with MOUNTED=ALL, The 
valid range of 1 is 0-224, with a default of zero. The value that is substituted for 
1 is normally the number of bytes that would be allocated by a given parameter 
on the LBLTYP statement. See Figure 4,47 in this Section to determine 
the number of bytes allocated for any given LBLTYP statement. 

If the JA parameter is specified and JALIOCS is not,the job accounting interface is 
generated but no alternate label area is reserved (16 bytes are reserved for the 
save area). The routine $JOBACCT must then use a device or method that does 
not require LIOCS label programming. If the J A parameter is not specified, the 
JALIOCS parameter is ignored. 






Section 4, Chapter 12 

PAGE MANAGEMENT 
TABLES 



The purpose of this chapter is to describe the tables that are used by the page 
management routines which may need to be inspected during program debugging. 
A knowledge of the concept of virtual storage is assumed. 



~~^, 



The Segment Table 

One segment table is generated within the supervisor area during system generation. 
Each entry in the segment table corresponds to one 64K segment of virtual storage. 



How to locate: 

The address of the first entry in the segment table is contained in bytes X'DO' to 
X'D3' of SYSCOM. Label STAB in the supervisor Usting identifies the address of 
the first byte of the segment table. The address of the segment table is also 
contained in control register 1. Refer to the example shown in Figure 4,53 



The Page Table 

One page table is generated for each segment of virtual storage during system 
generation. Each page table is 64 (decimal) bytes in length, and has 32 two-byte 
entries. Each entry corresponds to 2048 (decimal) bytes of virtual storage. As 
illustrated in Figure 4.52, the page tables occupy a consecutive area in the 
supervisor. 



Initialization of the Page Table 

After IPL, page table entries are initialized as follows: 

• All page table entries belonging to the supervisor area (nucleus and 
transient areas): 

Bit 13 = 

Bit 15 = 

Bits 0- 12 = the leftmost 13 bits of the address of the corresponding 

page frame. 

• All page table entries for allocated real partitions: 
Bit 13 = 

Bit 15 = 1 
Bit 0=1 
Bits 8-11 = storage key of the partition. 

• Page table entries belonging to virtual partitions: 
Bit 13=1 

Bit 15 = 1 
Bit 0=0 
Bits 8-11 = storage key of corresponding partition. 

• All remaining page table entries: 
Bit 13 = 

Bit 15= 1 
Bit = 1 
Bits 1-12 = 



V,,,y 
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How to locate 

The address of the page table belonging to the first 64K of virtual storage is 
contained in the first entry in the segment table. 

The address of the page table belonging to subsequent segments of virtual storage 
are contained in the associated segment table. Refer to Figure 4.52 which illustrates 
this. 

Appendix G shows an example of locating the segment table and page table in a 
dump. 

The figure below shows the format and contents of an entry in the segment 
table and an entry in the page table. The figure also illustrates the interconnection 
between these two tables. 



PAGE MANAGEMENT 
TABLES 



STAB (Segment table 



XTO' 



X'FO' 



X'FO' 



X'FO' 



Address of 
Page Table 



Address of 
Page Table 



Address of 
Page Table 



Address of 
Page Table 



Each entry in the 
segment table 
corresponds to one 
64 K segment of 
virtual storage. 

One page table is 
built for each seg- 
ment of virtual 
storage and 
contains 32 two-byte 
entries. 



PT (Page Table) 




0. 


1 



Bytes and 1 


: BitO 


1 = Address of any byte in the corresponding page 
is invalid. 




Bits 0-12 


Leftmost 13 bits of address of page in real storage 
if bit 13=0. 




Bits 8-1 1 


Storage key of corresponding partition if bit 13=1 
or if bit 0=1 . 




Bit 13 


= Page is in real storage; 

1 = Page is not in real storage. 




Bit 14 


Always zero. 




Bit 15 


= Page must be read from page data set, (a valid 
copy of the page is on SYSVIS); 

1 = Page need not be read from page date set, (there 
is not a valid copy of the page on SYSVIS). 



Note: Label STAB identifies the first byte of the table 

Label PT identifies the first byte of the Page Table. 

"^ Figure 4.49 Explanation of the contents of an entry in the Page Table. 

This figure also illustrates the relationship between the page table and the segment table. 



Debugging for Programmers, part 2 4. 1 19 



Section 4, Chapter 12 

PAGE MANAGEMENT 
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Page Frame Table 

The page frame table is built at supervisor generation time and contains one 8-byte V > 
entry for each 2K block of real storage (page frame) as specified in the RSIZE 
parameter of the VSTAB macro. 



How to locate: 

Bytes X'D4-X'D7' of the SYSCOM contain the address of the first entry in this 
table. Label PFT in the supervisor listing identifies the address of the first byte 
of this table. 

The format and contents of an entry in the page frame table is shown below. 






1 


2 


3 


4 


5 


6 


7 



>x 



\ 



\ 



\ 



Bytes and 1 : 



Bits 0-10 
Bit 11 
Bit 12 
Bit 13 
Bit 14 
Bit 15 



Counter for temporary fixes (tfix counter.) 

Reserved for later use. 

1= PFIX request (into another page frame) pending for the page . 

If on, page frame is unusable (hardware failure). 

If 0, page frame belongs to selection pool 

1= PFIX (different page) or GETREAL request pending for the page frame. 



Bytes 2 and 3: Pointer to next page frame in queue or to queue header if last element 
in the queue (all page frames in selection pool are queued). 

Bytes 4 and 5: If the frame is occupied, the page number (The virtual address of the 
page divided by 2048); if unused, X'FFFF'. 

Bytes 6 and 7 : Pointer to the previous frame in the queue or to queue header if first 

element in the queue (all page frames in the selection pool are queued). 



Figure 4.50 Explanation of the contents of an entry in the Page Frame Table. 

Page frame table extention (PFTX) 

This table is a one-byte appendage to each entry in the page frame table. It serves 
as a counter for the number of times a page has been permanently fixed in a page 
frame, and is called PFIX counter. 

How to locate 

Bytes X'D8' - X'DB' of SYSCOM contain the address of the first entry in this 
table. Label PFTX in the supervisor Hsting identifies the address of the first byte 
of this table. 
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CI 



Boundary Box 

This information block is generated in the supervisor during system generation. 
The area occupied by the boundary box is sufficient to contain up to six entries, 
depending on the number of partitions specified during system generation. The 
first entry contains information about virtual storage allocation, and the remaining 
entries contain information pertaining to each partition supported by the supervisor. 
If a partition is not supported by the supervisor, the beginning and end addresses 
are identical to those of the next partition. 
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TABLES 



#>. 



How to locate: 

Bytes X'DC - X'DF' of SYSCOM contain the address of the first entry in this 
information block. Label BBOX in the supervisor listing identifies the address of 
the first byte of this information block. Appendix G shows an example of locating 
the boundary box in a dump. 

The format and contents of the boundary box is shown below: 



3 


4 5 


6 7 


8 11 


12 


15 


End Address of Real Storage 


Number of 


Number of 








or Address of Alternate Area 


Page Frames 


Page Frames 


Begin Address of Virtual 


End Address of Virtual 




for PDAID or the start 


in smallest 


in Main Page 


Address Area 


Address Area + 1 




of the SD area for SDAID 


Real Partition 


Pool 









Fojrmat of the 
General Entry 



BBOX 



General Entry 



BG Entry 



Fn Entry 



F2 Entry 



F1 Entry 



"\ 



> 



The number of entries is equal 

to the number of partitions (NPARTS) 

specified at system generation + 1 . 



_y 



3 4 



Format of 
any entry 
7 8 



11 12 



.^JL5 



Begin Address of 
Real Partition 



End Address of 
Real Partition + 1 



Begin Address of 
Virtual Partition 



End Address of 
Virtual Partition + 1 



These values are inserted at IPL time but can be changed 
by ALLOCR command. 



These values are inserted at system generation time but can 
be changed by the ALLOC command. 



Note: The begin and end address fields for a partition that is not allocated both contain the begin address of the following partition. 
Figure 4.51 Explanation of the contents of the Boundlary Box 
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TABLES 

There are several methods of calculating real addresses from virtual and vice versa. 

One method is given below^. 

(The values assumed in the examples apply to the illustration opposite.) 

A. Converting a virtual address to real: 

1 . Write the hexadecimal virtual address in binary. For example (assuming 
a virtual address of 1FA20), 



0001 1111 1010 0010 0000 

2. Ignore the ten rightmost bits. For the example, this leaves 

0001 1111 10 

3 . If after step 2 the rightmost bit is a 1 , change it to a 0; if it is a 0, 
leave it 0. 

4. Convert the binary value obtained in step 3 to hexadecimal. 
For example, 

0001 1111 10 

I \ — 

7 E 

5. Locate the address of the page table, contained in the first entry of 
the segment table, the address of which is contained in CRl. (For 
example shown opposite, this is 6A28,) 

6. Add the address of the page table to the hexadecimal number obtained 
in step 4. 

For example, 

6A28 
7E 

= 6AA6 (This is the address of the entry in the page 
table associated with the virtual address to be 
converted to real. ) 

7. Locate the page table entry in the dump. 

8. Replace the right most bit of the contents of the page table entry 
by a 0. 

For example, as shown in the illustration opposite, the page table 
at address 6AA6 contains 01 B9. The right most bit is a 1 (X'9' = 
1001.) 

9. After replacing the right most bit by a 0, convert the resulting four-bit 
binary string to hexadecimal. 

For the example, 1000 - X'8'. 

The value thus obtained in this example is 01B8. 

10. Increase the value obtained in step 9 by attaching two Os to the right. 

For example, 1 B800 (This number is the address in real storage 

of the lower limit of the page frame in which 
the real address is located.) 

1 1 . Convert the eleven rightmost bits of the binary value obtained in step 1 
to hexadecimal. 

For example, 

010 0010 0000 

~l 1 — —T— 

2 2 

12. Add the value obtained in step 1 1 to the number obtained in step 10. 

For example, 

01B800 
^ 220 

01 B A20 (This is the real address. ) 
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Bytes X'D0-D3' of SYSCOM 

and 

Control register 1 

contain the address 
of the segment table. 



00006C80 



Page table 

Each entry represents "®^' address area 

2048 (dec) bytes of If the invalid-bit of the 

virtual storage. There page table entry is 

are 32 entries in set (=1 ), the page 

the page table for each resides in the real address 

entry in the segment area. 

table. 



Page frame table 

Each entry represents 2048 (dec) 
bytes of the real address area, and 
indicates the status of the 
attached page. 
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FO 00 6A 28 
6A 68 



6A A8 
6A E8 
6B 28 



6B 68 
6B A8 
6B E8 
6C 28 



Segment table 
Each entry 
represents 
64K (dec) 
of virtual 
storage. 




0000 



0008 
0010 



,^^^^ ■ 






\ \ 

\ 

\ 
\ 
\ 

\ 



0000 00 



00 08 00 



00 10 00 



01 BO 00 



01 B8 00 



01 CO 00 



3F 00 00 



3F7F FF 






t 

a 



\ 



00 3f 



Page frames 
^ allocated to 
the supervisor 



Page frames 
allocated to 
f partitions running 
in real mode 



Page fram«i 
y allocated to 
the page pool 



J 



End of real storage 



Explanation of the illustration. 

The segment table in this example starts at address 6C80. 

The page table starts at address 6A28. 

Three valid entries in the page table are shown allocated to three consecutive 

2K slots in the real address area. (The associated entries in the page frame 

table are indicated.) 

The page entry at address 6AA6 contains a value of 01B9 which is used in the 

example given on the opposite page. 

Figure 4.52 illustrates the relationship between the page management 
tables that are described in this chanter. 
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Converting a real address to virtual: 

1 . Write the hexadecimal real address in binary. For example, 

/01BA20i 
± A. 



0000 0001 1011 1010 0010 0000 

2. Ignore the eleven rightmost bits. Thus, for the example, 

0000 0001 1011 1 is the remaining binary number. 

3. Add three Os to the right of the binary number obtained in step 2. 

Thus 

0000 0001 1011 1000 

4. Convert this binary value to hexadecimal. 

For example, 

0000 0001 1011 1000 

n p -p- -p- 







1 



B 



8 



5. Add the number obtained in step 4 to the address of the page frame 
table. Bytes X'D4' - X'D7' of SYSCOM contain the address of the 
page frame table. (For the example, this is assumed to be 6100.) 
For example, 

6100 

^ IBS 



= 62 B8 

6. Locate this address in the dump. (This is the address of the page frame 
table entry associated with the real address to be converted.) 

7. Locate bytes 4 and 5 of this page frame table entry. (For the example, 
as illustrated in Figure 4.52, a value of 003F is assumed.) 

8. Write this hexadecimal number in binary. 

Thus for the example, 

0000 0000 0011 1111 

9. Ignore the leftmost three bits, and add three Os to the right hand end 
of the resulting binary string. 

Thus, 

0000 0001 1111 1000 

~T~ "T~ ~T- — T" 






v„ .y 



10. Add two zeros to the right of this hexadecimal number: 01F800 

1 1 . Convert the eleven rightmost bits of the real address (as written in 
binary in step 1) to hexadecimal. 

For example, 

010 0010 0000 

1 r~ "T- 

2 2 

12. Add the number obtained in step 10 to the number obtained in step 1 1 , 

For example, 

01F800 
220 



01 FA20 (This is the virtual address.) 
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EVENT PGM CHK INTERRUPT TOO MICSEC 
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GPR 8-F OOOOOCno 00000000 00000000 
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00200000 
0024000C 
00280000 
00200000 
FFFF02CO 
FFFF0188 
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FFFF01B8 
FFFF0240 
FFFF0218 
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00020000 0025Q«r1Xi 00020000 
CC020000 aiM4p00O 00020000 
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Figure 4.53 An example of an SDAID "dump on program check" showing how 
to locate the page management tables 
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Channel program translation 

This chapter describes the control blocks used by the DOS/VS channel program 
translation routines, which may require examination under certain circumstances 
of a system malfunction. 



'\...,>'' 



The functions of the translation routines depend on whether the fast CCW 
translation option (FASTTR in the macro FOPT) is active or not. 

The first part of this chapter describes the operations without the fast trans- 
lation option, and the second part deals with the additional control blocks 
and functions for fast CCW translation. 



For a full description of the channel program translation routine, refer to the 
DOS/VS Supervisor Logic manual. 



General functions (without fast translation) 

Because the DAT (dynamic address translation) feature is not available for data 
and channel command words of I/O operations, software routines are required that 
perform the following functions for an I/O request from a virtual partition: 

1. The CCB and, if applicable, the user sense CCW will be copied into a buffer. This 
buffer is called the CCB copy block and is maintained by the CCW-translation 
buffer management. 

If another I/O operation from a virtual partition is requested, the copied and 
translated CCB is queued behind the first request in the CCB copy block queue. 
Label ACCBB in the supervisor listing points to the address of the CCB copy 
block queue. Displacement X'44' from this address contains the address of the 
second CCB copy block. , 

2. The complete channel program, consisting of one or more CCWs, will be copied 
into a buffer area called the CCW copy block. The copied channel program is 
logically equivalent to the original channel program, the data addresses being 
translated to real addresses. The copy process conserves the channel program 
structure, but TIC (transfer in channel) commands will be inserted in the copied 
channel program when there are more than seven CCWs in a channel program. 
Figure 4.57 shows a channel program having eleven CCWs; two copy blocks that 
are linked by a TIC command are therefore required. Figure 4.58 illustrates the 
format and contents of the CCW/TCB. 

3. Addresses in the copied channel program that refer to an I/O area in a virtual 
partifion are translated into the corresponding real addresses. If the I/O area is 
completed on one page, the real address will replace the virtual address in the 
copied channel program. If the I/O area occupies more than one page (crosses 
page boundaries), an IDAL (Indirect Data Address List) block is built up. The 
IDAL block contains the real address of the I/O area and the real page addresses 
of any pages occupied by the I/O area. The address of the IDAL will replace 
the virtual address in the copied CCW, and the IDAL bit (bit 37 in the CCW) 
will be set to 1 . If the virtual channel program already uses the IDA feature, 
both the IDAL from the virtual partition copied and the virtual addresses will be 
replaced by the corresponding real addresses. 

Figure 4.54 illustrates the actions described in points 1, 2 and 3 above, and 
Figure 4.55 illustrates the relationship between the blocks described. 
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User-task 



EXCP 



Via dispatcher 



user-task 



Under PI K of usertask 
that requested I/O 



Via dispatcher 



Move parts of copied CCB 

to original CCB 

Release buffer of copied CCB 

Reset indicator for moved 

CCB 



• Copy CCB 

• Copy CCWs 

• Translate copied CCB 

• Fix data areas 

• Build IDALS (if required) 

• Translate copied CCWs 

• Enqueue request to channel 
queue 

• Start I/O 



l/0-interrupt handler 



l/0-interrupt belonging to above 
mentioned l/0-request 

• (handle ERP) 

• Transfer interrupt information 
from CSW to copied CCB 

• Post CCB, post task dequeue 

• Dequeue request from channel queue 

• Retranslate CCW- address in 
copied CCB to virtual 

• Free data areas 

• Release copy buffers, except 
that of CCB 

• Set indicator and move CCB 
if necessary 



Under PI K of interrupted task 



Figure 4.54 Illustrates the activity between user program and supervisor during 
the handling of an I/O request from a program running in virtual 
mode. 
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Additional functions performed by the channel program translation routine are: 

4. A sense CCW(if applicable) is updated in the copied CCB. 

5. All I/O areas required by the channel program must remain in real storage until 
the I/O operation is complete. For this reason all pages involved with an I/O 
operation are fixed in real storage. 

After the above functions have been performed, the I/O request is handled as if it 
were a request from a real partition. The following supervisor activity then ensues: 

1. The request is placed in the channel queue. 

2. A START I/O is issued. 

3. The corresponding interrupts are processed. 

4. The ERPs are activated (error recovery procedures in case of I/O device errors). 

5. Status information is posted in the copied CCB. 

6. The request is removed from the channel queue. 

After completion of an I/O request from a virtual partition, the channel program 
translation routine translates the real command address (from the CSW) to the 
corresponding virtual address, frees all fixed pages that were required by the 
request, transfer parts of the copied CCB to the virtual CCB, and releases all areas 
used by the buffers required by the channel program translation routine. 

Figure 4.54 illustrates the complete operation described above under points I 
through 5. 






IDAL block 

The IDAL block is generated by the CCW translation routine if the I/O area 
specified in a CCW crosses page boundaries. The IDAL blocks are placed in the 
buffer area at the end of the supervisor together with associated CCB and CCW 
copy blocks. Each block contains real addresses of the data areas in real storage. 
Because each address is 4 bytes in length, an IDAL block can contain up to 1 8 
addresses (also referred to as IDA words.) Each IDAL must be completely 
contained in one IDAL copy block. If more than one I/O request requires an IDAL, 
as many IDALs are placed in one IDAL copy block as will fit. 

The figure opposite shows the relationships between the blocks. 

Appendix G shows an example of locating a CCB copy block and CCW copy 
block in a stand-alone dump output. The CCB address in the channel queue is used 
as the initial pointer. 



CCB copy block 

CCB copy blocks are placed in a buffer area (specifically reserved for the channel 
program translation routine) at the end of the supervisor together with the 
associated CCW copy blocks and IDAL block (if required). Each CCW copy block 
consists of nine entries. The first seven entries are used to store copied CCWs, and 
the remaining two entries (16 bytes) contain pointers and end-of-buffer indicators. 
The format and contents of a CCW copy block is shown in Figure 4,56 
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VIRTUAL STORAGE 
USER PARTITION 



Original CCB 



Original CCWs 



CCW1 



CCW2 



CCWS 



I/O Areas 



•► B 




■► A (1st part) 


A (2nd part) 





CHANNEL PROGRAM 
TRANSLATION 



— page boundary 



r 



real storage 
"su^erViso^ 



Channel Queue Entry 



I 




a third 

CCW copy block 



page b. 



page b. 



Figure 4.55 Illustrates the relationship between an ordinal channel program in a 

virtual partition and the copy blocks required by the channel program 
translation routines. The input /output areas in real storage are also 
shown. 
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15 16 



23 24 



25 26 



27 



28 



31 32 



35 36 



39 



Copied and 
updated CCB 


Sense CCW 
(if any) 


User PIK 


Flag 
byte 


Unused 


Virtual address 
of CCB 


Address of first 
CCW copy block 


Address of first 
IDAL block 



40 



63 64 



67 68 



71 



Fix 
information 


Pointer to 
additional fix 
information 


Address of next 
CCB copy block 



If fast CCW translation is specified (FASTTR --- YES) 
tfie last twelve bytes of tfie block ar.e changed to; 



•> 


60 63 


64 67 


68 


71 


i 


Address of 
REPLICA block 


Forward chain 
pointer 


Backward 
pointer 


chain 


d 











Field 


Description 


User PIK 


The PIK value of the virtual I/O requestor. This value will be used by the 
MOVECCW routine to identify the requestor's CGBs. 


Flag byte 


Bit 0:1= Translation complete 
1:1 = Pages fixed 
2 : Not used 

3:1 = BTAM Second Time Request (I/O request from BTAM appendage) 
4:1 = Valid for fast translation 
5:1= CCB copy block is on saved CCB queue 
6:1 = Data area pages require fixing 


Fix information 


Each bit in this field corresponds to a physical page frame. If a bit is set to one, 
the corresponding frame is fixed for the current I/O request. The 128 bits in this 
field are sufficient for a Relocate system with up to 384K bytes of storage. 


Pointer to addi- 
tional fix infor- 
mation 


If real storage is greater than 384K, the fix information is logically continued in 
another copy block with 68 usable bytes, corresponding to 1032K of additional 
real storage. The address in this field points to the additional copy block. 


Address of 
REPLICA block 


If fast CCW translation is active, this field contains the address of the REPLICA 
block which holds the copies of the CCB and CCW(s) of the channel program. 


Forward and 
backward chain 
pointers 


The saved CCB queue used by the fast CCW translation routines is a two-way 
queue and thus needs two chain pointers. These pointers are kept in these 
two fields. 



Figure 4.56 Explanation of the contents of the CCB copy block 
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Channel Program without TIC or SEARCH Commands 

The CCWs in a channel program without TIC or SEARCH commands are copied 
into sequential locations in the CCW copy buffer. If the program has more than 
seven CCWs, a TIC is inserted in the eighth copying position and is made to point 
to the first CCW in the next copy buffer. CCWs 8 through 14 are then copied in 
the next copy buffer. If there are more than 14 CCWs, the process is repeated 
until all CCWs are copied. 

Refer to the DOS/VS Supervisor Logic manual for a full description of the CCW 
copy block when using TIC and SEARCH commands. 

The figure below shows the copying of CCWs for a channel program requiring 
two CCW copy buffers. 
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VIRTUAL STORAGE 



REAL STORAGE 
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Virtual Channel Program 

CCBNAME CCB SYSxxx, CCW1 

CCW1 CCW 

CCW2 CCW 

CCW3 CCW 

CCW4 CCW 

CCW5 CCW 

CCW6 CCW 

CCW7 CCW 

CCWS CCW 

CCW9 CCW 
CCW10 CCW 
CCW11 CCW 



Copied CCB (See Figure 4.50). 




CCW Copy Block 1 
(See Figure 4,58) 



CCW Copy Block 2 
(See Figure 4.58) 



Legend: TIC 

ACCW8 

ANB 

VBA 



Transfer in channel command 

Address of CCW8 

Address of next CCW Copy Block 

Virtual Address of CCWl (for Copy Block 1) and virtual 

address of CCWS (for Copy Block 2). 



Figure 4.57 A channel program requiring a TIC to be inserted in copying. 
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1 


2 


3 


4 


5 


6 


7 





1st Copy location for CCW 


8 


2nd Copy location f6r CCW 


16 


3rd Copy location for CCW 


24 


4th Copy location for CCW 


32 


5th Copy location for CCW 


40 


6th Copy location for CCW 


48 


7th Copy location for CCW 


56 


X'80'» 


X'OOOOOO' 


Virtual address of first CCW in the 
Copy block 


64 


X'88'*» 


X'OOOOOO' 


Address of next CCW Copy block in 
the chain 



X'80' indicates the end of the CCW copy locations in the block. It is replaced by a TIC 
(Transfer in Channel command) if the 7th copy location contains a copied CCW with data- 
or command chaining. Bytes 57-59 will then point to the copy location of the CCW 
following the CCW in the 7th copy location. 
Bytes 56-59 will not be changed if the CCW in the 7th copy location is a TIC. 

X'88' indicates the last 8-byte entry in the block. It is replaced by a TIC if the CCW in the 
7th copy location is a status modifier CCW. For example a SEARCH command to a disk. 
Bytes 65-67 will then point to the copy location of the second CCW following the stiatus 
modifier CCW. 



Figure 4.58 Format and contents of a CCW copy block 
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Translation Control Block 

The routine CCWTRANS is called by the channel scheduler whenever a channel 
program must be copied and translated. Since a page fault may occur during 
CCWTRANS, the routine and its subroutines are reenterable and can therefore 
process several translation requests concurrently. In order to make CCWTJIANS 
reenterable a translation control block (TCB) is built for each task to serve as a 
dynamic work and save area. Each TCB is located behind the special save area for 
its task and has the format shown in the figure below. 

How to locate: 

To locate the TCB (associated with the partition/ task), add X'50' to the address of 
the System Save Area (displacement X'09' of the appropriate PIB). Labels 
CCWTCBl - CCWTCBn identify the first byte of the appropriate TCB. 
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Format 
of any TCB 




28 



3 4 



7 8 



11 12 



15 16 



19 20 



23 24 



27 



Flag 

byte 

* 


used 




Pointer to 


Pointer to 


Pointer to 
TIC line 


Pointer to 


Address of 


Number of 


by 


TIK/PIK 


Status Modifier 


Control Com'd 


Copy Block 


copied COB 


free IDA words 


BTAM 




List 


List 


End 


(for cancel) 


m IDAL blocks 



47 48 



51 52 



55 56 



59 60 



61 62 



63 64 



67 



Work Areas 



Address of 
last TFIX 
request 



Pointer to 
DIDAL Cham 



Address of 
current DIDAL 



Number of 
DIDALS 
in use 



Number of 
free DIDAL 
entries 



Address of 
current 
DIDAL entry 



68 



71 72 



127 128 



131 



Virtual 

CCW address 


Save Area 
(Registers 2-F) 


Pointer to 
next used 
TCB 



Byte 0: bit 



data chaining specified 

Read /Sense command specified 

Read backward command specified 

Status modifier command with data chaining 

Status modifier command only 

Reserved 

Reserved 

REPLICA creation flag (fast CCW translation) 



Note: One TCB is generated for each partition supported. 

With asynchronous processing support, 1 5 TCBs are generated. 



Figure 4.59 Explanation of the contents of the TCB. 
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Fix Information Blocks 



In order to keep track of which page frames have been TFIXed for a request, a bit 
string is used which has a bit for at least every page frame up to the hi^est one 
which is TFIXed. If no page is TFIXed in an address higher than 384K, then the bit 
string in CCBXINF is sufficient (192 bits = 384K). Whenever a page is TFIXed, the 
bit corresponding to its page frame is set to one. If a page is used more than once 
by a single request, it is TFIXed only once. 

If a page is TFIXed at a location beyond 384K, one or more additional bit strings 
must be added. This is done by enqueuing a copy block. Each copy block thus 
enqueued provides fix information for an additional 1088K of real storage. The 
additional blocks are queued with the first one being pointed to by the field 
CCBXPTR in the CCB copy block. The figure shows how fix information is kept. 



c 



Fix-String: 

bit-table where each bit belongs 
unequivocally to a page frame 
(for 1038K bytes); if a bit is on, 
the page frame belonging to this 
bit has been TFIXed for this 
l/0-request. 

ANB: 

—0 if Fix-block is last one in 

Fix-block queue. 

—address of next Fix-block. 



Fix-string 
of 544 bits 



+68 ANB 



iO 



Fix-bit string •*'-^— rcRX 



represented 
page frame 



'ojiiojoio 



:iNF- 



OK 



|0|0|0 



oiiloj io|o 



TFIXd) 



-Fix-string 1- 



384K 



-Fix-string 2- 



TFIX(2) 

384K 

-I-1088K 



384K 
-I- 1 088K 
+ 1088K 



• if for a specific page frame the Fix-bit is already on, no TFIX-request is transferred to the 
page manager 

• the TFJX-biocics are freed after l/0-request has been posted complete 
Figure 4.60 Fix information Bit String and Block 



General Rules for channel progrann translation 

The following rules apply to IBM-supplied channel program translation routine 

1. Channel program translation is skipped: 

• for I/O requests from programs running in real mode 

• for I/O requests from system tasks (FETCH/LOAD has its own small CCW- 
translation.) 

• for I/O requests for console when console buffering option is supported 

2. Channel program translation is modified for BTAM running in virtual mode 
(modify CCW-chain from I/O appendages). 

3. The following components work via copied and translated CCW chains: 

• CRT 

• seek separation routine 

• ERPs 

• BTAM-ERPs 

4. Channel program translation does not support: 

• self-modifying channel programs 

• start of I/O requests from I/O appendages for not translated channel programs 
(except BTAM) 

• time dependent I/O requests (channel program may get longer after translation) 

• channel programs with CCWs whose count is 32K (invalid) 

• channel programs with data chaining in connection with TIC-commands when 
the same CCW gets different command codes during execution of channel 4 
program. I 
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Section 4, Chapter 13 

Additional functions for fast translation CHANNEL PROGRAM 

. . . . , . . r • ., . , TRANSLATION 

In order to save time when translating a series of similar channel programs, 

the translation routines attempt to save and reuse any channel programs that 
have already been translated and to keep the pages containing the associated 
I/O areas fixed in real storage. This is carried out until the number of copy 
blocks in the copy block pool becomes insufficient and/or the paging rate be- 
comes too high due to the large number of fixed pages. 

In Older to carry out these operations, the translation routines require two 
additional control blocks: 

REPLICA - a copy of a virtual channel program and its vir- 
tual CCB. 

DIDAL - a double-word indirect data address list which is 

used to locate the I/O areas in real storage. 

These blocks and their formats are described in more detail later in this 
chapter. 



Operation (see Figure 4.61) 

When the fast translation option is active, the translation routine first 
checks, after receipt of a channel program that is to be translated, whether 
there is a REPLICA of this program available. If so, the translation routine 
tests whether the pages containing the I/O areas for the program are still 
fixed, fixes the pages again if necessary, and returns control to the calling 
routine. 

If there is no REPLICA of the channel program available, normal CCW 
translation takes place and the DIDAL blocks are built. The translation 
routine then ciiecks if the channel program is valid for fast translation 
(the CCWs must be contiguous and the requesft may not come from BTAM). 
If so, a REPLICA of the channel program is built and stored for future 
use. 

The resulting structure of the control blocks after fast translation is 
shown in Figure 4.62, which uses the same sample channel program as Fi- 
gure 4.55. 

After completion of the I/O request, the channel program translation rou- 
tines simply retranslate the CSW command address, move the CCB from the 
active queue to the top of the saved CCB queue, and transfer the necessary 
parts of the CCB copy to the virtual CCB. If, however, there is an insufficient 
number of copy blocks in the copy block pool, the routine frees the I/O 
areas and releases the copy blocks of the least recently used CCB copy. If 
the paging rate exceeds a given threshold, the I/O areas of the least recently 
used CCB copy with fixed pages are freed, but the copy blocks are retained. 



DIDAL block 

The DIDAL block is created by the CCW translation routine in order to save 
the virtual addresses of the I/O areas and the addresses of the locations which 
contain the corresponding real addresses (CCW copy or IDAL block). The 
formats of the DIDAL block and its entries are shown in Figure 4,63. Each 
DIDAL block occupies one or more copy blocks. 
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REPLICA block 

The REPLICA block is created by the CCW translation routine and contains 
replicas, or copies, of the CCB and CCWs of a channel program. The first, or 
main, REPLICA block also contains additional header information. If there 
is insufficient space in the main REPLICA block, additional blocks, without 
the header, are added. Each main or additional block occupies one copy block. 
The formats of the main and additional REPLICA blocks are shown in Figu- 
re 4.64. 



■> 



Queue organization 

Similarly to the normal channel program translation, the CCB copy blocks 
for which I/O is being executed, or is to be executed, are placed in the channel 
queue, which can be regarded as an active CCB queue. All pages containing 
I/O areas for CCBs in this queue are fbced. 

After completion of I/O operations for a given channel program, the CCB copy 
is placed in a second queue, called the saved CCB queue, and retained until 
it is needed again or is deleted. The pages associated with CCBs in this queue 
may or may not be fixed. 

Each partition contains a REPLICA queue which holds the REPLICAs of the 
channel program issued by the partition. 

An example of the three queues is shown in Figure 4.65. 



V. 
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I CSWTRANS j 



CHANNEL PROGRAM 
TRANSLATION 



Retranslate 

CSW 

information 



Fast 




translation 



yes 



Free 

I/O areas 



Release copy 
blocks 
except CCB 



Move CCB copy 
from active queue 
to top of saved 
queue 



yes 



REPLICA 
generation 



Transfer 

information from 
CCB copy to 
virtual CCB 




RETURN 



Free I/O areas 
and copy blocks 
of least 
recently used CCB 



Free I/O areas of 
least recently 
used CCB witfi 
fixed pages 



Figure 4.61 Basic flowcharts of fast CCW translation 
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VIRJUAL_STORAGE 
USER PARTITION 



T 



Original CCB 



Original CCWs 



CCW1 



CCW2 



CCW3 



I/O Areas 




— page boundary 



REAL STORAGE 

SUPERVISOR 

REPLICA 



Channel Queue Entry 





i: ^"^ 














ix: .^ . 








i 




i 




r 


"* 




DIDAL 








Figure 4.62 Control block structure for fast CCW translation 
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DIDAL BLOCK 



ENTRY 1 



CHANNEL PROGRAM 
TRANSLATION 



DIDAL ENTRY; 



VIRTUAL ADDRESS 


FLAG 
BYTE* 


POINTER TO REAL 
LOCATION** 



£^) 



Legend FLAGBYTE: bit 



bit 7 



indicates that TFIXing is 

not necessary because the 

page has already been TFIXed 

for this request 

indicates that TFIX-request 

for this entry has been completed 



Real location (either copied CCW or IDA-word) 
that should contain the translated I/O area address. 



Pointer to (next) additional DIDAL. Contains 
4X'00' in last DIDAL. 



Figure 4.63 Format of DIDAL block and DIDAL entry 
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MAIN REPLICA BLOCK 



VCCBA 


RCCBA 


TIMEST 


REPPIK 


REPFLAG 


CCWSTRL 


REPDIDAL 


REPDCB 






CCB 
(16 or 24 BYTES) 








CCW1 


CCW2 


CCW3 


REPFPT 


REPBPT 


REPNEXT 



(f 



\..y 



ADDITIONAL REPLICA BLOCK 



CCW4 



CCW5 



REPNEXT 



V.,. 



Legend: 

VCCBA 

RCCBA 

TIMEST 

REPPIK 

REPLCNT 

CCWSTRL 

REPDIDAL 

REPDCB 

REPFPT, 
REPBPT 

REPNEXT 



Virtual CCB address 

Address of copied CCB 

Timestamp 

Partition identification key 

The number of tasks currently testing this 
REPLICA for a match with their channel program 

Length of CCW string (number of CCWs) 

Address of DIDAL block 

Pointer to chain of DIDAL blocks 

Pointers used for chaining REPLICAs 
(forward and backward pointer) 

Pointer to (next) additional REPLICA block 



Figure 4.64 Format of REPLICA blocks 
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CHANQ 



Active 

CCB 

Queue 




CCB copy blocks. 
One copy block per CCB 
All associated pages can 
be either fixed 



or not fixed 



Pointer 
to the 
lowest 



cm 1 

\ 



From 
PI 
or 
TIK 



REPLICA 
1 




REPLICA 
2 



REPLICA 
3 



REPLICA 
4 



REPLICA blocks. 
One or more copy 
blocks per REPLICA. 
Only one is shown 
here. 



REPLICA - 

queue for each partition /task , 

(only one queue is shown) 



2 System queues: 

Active CCBs, all associated pages fixed. 
Saved CCBs, CCBs having their 
associated pages fixed come first. 



Figure 4.65 Queue organization for fast CCW translation 
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Appendix A 

PD AREA TABLES 





Byte 



4 

8 

12 

16 

20 

24 

28 

32 

36 






PDAREA 


PDAREAND 






PDINTRHK 






PDSIQHK 






PDTRANHK 






PDFLTHK1 






PDFLTHK2 










PDREGSAV 















Address of end of PD area 

• Address of interrupt trace hook* 

■ Address of START I/O hook* 

• Address of transient durnp hook* 
-Address of F/L trace hook 1 * 

• Address of F/L trace hook 2* 

■ Reserved 

■ Save area for registers 9, 10, and 1 1 



*A hook is coding introduced at supervisor generation. The coding normally branches around 
itself. The initialization makes the branch instruction a NOP to allow a PDAID function to be 
performed. 

Figure A.l. The PD address table (Displacements are in decimal) 

Byte 





8 

16 

24 

32 

40 

48 



1 

Phase Name 



VER 



MOD 



IGN2/TRC2 
CUU 



Log 
CUU 



— I- 
Alternate Area End 



IGI\I3/TRC3 
CUU 



PRT1 



PRT2 



PRT3 PRT4 



Output 
CUU 



IGN1/TRC1 
CUU 



Alternate Area Start 



CHANC PTR 



Reserved 

1 



Reserved 



Reserved 



OPT 



Register I/O 



Displacement 


Label 


Description 


0-7 


Phase Name 


Phase being run 


8 


VER 


Version number in hex 


9 


MOD 


Modification level in hex 


10-11 


LOG 


Address of system log device 


12-13 


Output 


Address of output device 


14-15 
16-17 
18-19 


IGN1/TRC1 
IGN2/TRC2 
IGN3/TRC3 


Address(es) of devices to ignore or trace 


20-23 


Alternate 
Area Start 


Start address of alternate area 


24-27 


Alternate 
Area End 


Ending address of alternate area 


28-31 


CHANQ PTR 


Address of channel queue pointer for SYSLOG 


32 
33 
34 
35 
36 


PTR1 
PTR 2 
PTR 3 
PTR4 
PTR 5 


Partitions to be ignored (see note) 


37-50 


Reserved 




51 


OPT 


Option byte X'OO' = TRC device 
X'80'= IGN device 


52-55 


Register 10 


Save area for register 10 (used by GSVC trace only) 



v 



Note: The initializer inverts the logic. When the user specifies a partition (s) to be traced, PDAID 
enters the partition (s) to be ignored in the standard preface table. 

Figure A.l. The PD Standard Preface Table (Displacements are in decimal) 



A.2 Appendixes 



1 I 



PIK (Partition Identification Key) 

During debugging, it may be necessary to locate and to be able to interpret the PIK 
value allocated to each partition. 

The PIK of each partition is determined during system generation the PIK value 
being contained in a two byte field at displacement address X'2E' in the appropriate 
partition communication region. Byte of this location always contains X'00\ 
and byte I a hex number equal to the displacement from the start of the PIB to 
the start of the entry in the PIB belonging to the partition. 
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Foreground partition PIK 

The PIK value for foreground partitions depends on how many partitions are 
specified by NPARTS parameter of SUPVR macro. 



PIK 


\ia\ue at displacement address X'2E' of foreground COMREGs, 
where byte = X'OO' and byte 1 = ; 




NPARTS=5 


NPARTS=4 


NPARTS=3 


NPARTS=2 


PIK value 


ndicated 


50 
40 
30 
20 


40 
30 
20 


30 
20 


20 


F1 
F2 
F3 
F4 



Note: The PIK values for foreground partitions do not change during system 
operation. 

Figure B.l. PIK Values 

Background partition PIK 

The PIK value for the BG partition is always X'lO'. However, unlike the values in 
the foreground communication regions, the value held in this address changes during 
system operation. It always contains the PIK value of the active partition. 



Attention P/K 

A separate PIK value is given to the attention routine. The value is X'OO', and 
indicates that the logical attention routine is in control. 



SYSLOG ID 

For PD output, values will be AR, BG, F4, F3, F2, or Fl, which identify the 
partition generating the trace entry. 

Normally, this ID is the prefix of all messages to SYSLOG on the console, if the 
related partition can be determined. If not, it is SP. 
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TIK, LIK, LTK 



TIK (Task Interrupt Key) 

The halfword TIK at displacement X'5A' in the SCP Communications Region 
(SYSCOM) has a zero value in the high-order byte and a key value in the low-order 
byte. This key value is only significant when AP is supported. The key value in 
the TIK is the key of the program (task or subtask) that is being serviced. When an 
interruption occurs, the value of the TIK indicates to the supervisor which program 
(task or subtask) was interrupted. 

The TIK is set by Task Selection in the General Exit Routine and equals the index 
displacement of the task's Program Information Block (PIB) within the PIB Table. 

Depending on the number of partitions supported, the value of the TIK indicates 
which task was interrupted according to the following table: 



TIK Value 


Interrupted 


NPARTS=2 


NPARTS=3 


NPARTS=4 


NPARTS=5 


Task 


X'OO' 
X'10' 

X'20' 

X'30'- 

X'FO' 


X'OO' 
X'10' 

X'20' 

X'30' 

X'40' - 

X'FO' 


X'OO' 
X'10' 

X'20' 
X'30' 
X'40' 
X'50' - 
X'FO' 


X'OO' 
X'10' 
X'20' 
X'30' 
X'40' 
X'50' 
X'60' - 
X'FO' 


Attention 
BG 
F4 
F3 
F2 
F1 

Subtasks* 



*Asynchronous Processing option. The number of PIBs initially available for subtasks is 10, 1 1 , 
12, or 13, depending on the number of partitions (in an AP supervisor the total number of 
PIBs is always sixteen). 



LI K (Logical Transient Owner Identification Key) . ^ 

The halfword UK at displacement 88 in the SCP Communications Region (SYSCOM) V...^ 

is only significant if AP is supported and contains the same value as the TIK when 

the logical Transient Area (LTA) is in use. LIK therefore, identifies the owner of 

the LTA. When the LTA is free, the halfword LIK contains zeros. The SVC 2 

routine sets the LIK, and the SVC 1 1 routine resets it to zero. If AP is not supported 

the LIK contains zeros. 



LTK (Logical Transient Key) 

The halfword LTK at displacement X'6E' in each partition's communications region 
has a zero value in the high-order byte and a key value in the low -order byte. 

In a foreground communications region, the key value in the LTK is not significant. 
The LTK in the backgratund communications region (BGCOMREG) has the same 
value as the PIK of the partition of the task that owns the LTA. or contains zeros 
when the LTA is free. When the LTA is occupied by a task, therefore, the 
BGCOMREG has the same value in its LTK as in its PIK when the owning task is 
active. The SVC 2 routine sets the LTK, and the SVC 1 1 routine resets it to zero. 
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REQID (I/O Requestor's Partition or System Tasl< ID) 

The REQID is one-byte identifier in the Channel Queue (CHANQ) entry. 

When a background or foreground program has requested I/O, the REQID has the 
same value as the key byte of the PIK for that task's partition. When the Attention 
Task has requested I/O, the REQID contains X'OO'. 



Appendix B 

REQID, TKREQID, SELECT 



When the request 


for I/O is from a System Task, the REQID has one of the 


following values: 




x'or - 


SNS 


X'02' - 


DSK 


X'03' - 


RAS 


X'04' - 


PMGR 


X'06' - 


PAGEIN 


X'07' - 


SUPVR 


X'09' - 


CRT 


X'OB' - 


ERP 


X'OF' - 


SVT 



The REQID is set by the Channel Scheduler Routine. 



TKREQID (I/O Requestor's Task Identification) 

The TKREQID is a one-byte identifier in the Channel Queue (CHANQ) entry for 
a task that has requested I/O (see Figure 4. 1 3). In an unused CHANQ entry the 
TKREQID contains X'FF'. 

The TKREQID byte in an active CHANQ entry has the same value as the key byte 
of the TIK of the task that has requested I/O. 

If AP is not supported it has the same value as the PIK of the task that requested 
the I/O. 

TKREQID is set by the Channel Scheduler Routine and reset by the I/O 
Interrupt Handler. 

SELECT 

This byte at displacement X'45' in the SCP Communications Region (SYSCOM) 
indicates v^hich system task has control. 
Possible values are: 



x'or 


- SNS 


X'02' 


- DSK 


X'03' 


- RAS 


X'04' 


- PMGR 


X'06' 


- PAGEIN 


X'07' 


- SUPVR 


X'09' 


- CRT 


X'OB' 


- ERP 


X'OF' 


- SVT 



When this byte contains X'OO', no system task is active. 



ilUlA&S 



Appendix C 

CONTROL REGISTER 
ALLOCATION 



Control 
Register 



10 



11 



12 



13 



14 



15 



SYSTEM CONTROL 


TRANSL. CONTROL 


EXTERNAL-INTERRUPTION MASKS 


SEGM-TBL LENGTH 


SEGMENT-TABLE-ORIGIN ADDRESS 




CHANNEL MASKS 














MONITOR MASKS 


PER EVENT MASKS 




PER GR ALTERATION MASKS 




PER STARTING ADDRESS 




PER ENDING ADDRESS 






ERROR-RECOVERY CONTROL & MASKS 






MCEL ADDRESS 



V._.^' 



Figure C. 1 Control Register Allocation 
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Appendix D 






The following two examples show the two different features of the ESERV program: 
that of de-editing without updating an edited macro definition, and that of de-editing 
and updating an edited macro definition. 

Sample Coding for De-editing without Updating a Macro Definition 

// JOB NO UP DATE (See note 1) 

// EXEC ESERV (See note 2) 

PUNCH E.MAC1,MAC2 (See note 3) 

/* 
/& 

Notes: 

1. Name of job is NO UPDATE. 

2. Causes ESER V to de-edit the macro specified in the following PUNCH 
statement. 

3. Causes the macros MACl andMACl to be punched out from the macro 
library (E) 

You could use the above coding to produce a de-edited source macro for possible 
future updates. 

Sample Coding for De-editing and Updating a Macro Definition 

The Procedure in the following exatnple produces a de-edited, updated macro 
definition in source format, and edits and places the update macro definition in 
the macro library, using the MAINT program. 



ESERV EXAMPLE 
JOBSTREAMS 



//JOB UPDATE 
// EXEC ESERV 

GENEND 



DSPCH E.MAC1 



) COL 77,4 
) VER 72+1,5 



Causes ESERV to de-edit the macro 
specified in the following DSPCH statement. 
Causes an END and /* statement to be 
generated. These are necessary to allow 
output from ESERV to be used immediately 
as input to assembler program. 
Causes the macro definition MAC 1 to be 
punched and printed from the macro 
library (E). 



.PP9 

) ADD 72+1 

AIF (&PCH NE 1400).D4 
) DEL 102,103 
) REP 245 

JOYCE CLC 0(4,REGG),BLANKS 
) END 
/* 

// PAUSE 

//OPTION EDECK,NODECK 
//EXEC ASSEMBLY 

(deck produced by ESERV 

goes here) 
/* 

// PAUSE 
//EXEC MAINT 

(deck produced by 
assembler goes here) 
/& 



Check list, move deck to reader. 
Causes the assembler to produce an edited 
deck (EDECK): no object module 
will be produced (NODECK). 



Move SYSPCH deck to reader. 
Causes MAINT to put edited macro 
definition on macro library. 
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Appendix E 

PROGRAM EVENT 
RECORDING 



The purpose of the program-event-recording facility is to assist in debugging 
programs, for example, SDAIDS, It permits the program to monitor the following 
events: 

• Successful execution of a branch instruction within the 
designated virtual storage limit 

• Alteration of the contents of designated general registers 

• Fetching of an instruction from designated storage locations 

• Alteration of the contents of designated storage locations 

The information for controlling program-event -recording resides in control 
registers 9, 10, and 1 1 , and consists of the following fields: 

Control register 9: 



EVENT M. 




GR ALTERATION M. 


8 16 31 
Control register 10 (X' A'): 




STARTING ADDRESS 


8 31 
Control register 1 1 (X'B'): 




ENDING ADDRESS 



8 



31 



PER Event Mask: Bits 0-7 of control register 9 specify which events are monitored. 

The bits are assigned as follows: 

Bit 0: Successful Branching 

Bit 1 : Instruction Fetching 

Bit 2: Storage Alteration 

Bit 3: General-Register Alteration 

Bit 4: Unassigned 

Bit 5 : Unassigned 

Bit 6: Unassigned 

Bit 7: Unassigned 

Bits 0-3, when ones, specify that the corresponding events are monitored. When a 

bit is zero, the event is not monitored. 

A PER event is signalled as a progfam interrupt. 



'K^y 
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Appendix E 

The monitor call instruction provides the capability for passing control to a MON ITOR CALL 

monitoring program such as the IBM supplied SDAID trace routines, when selected 
indicators are reached in the monitored program. The indicators are MONITOR CALL 
instructions implanted in the monitored program. When executed, these instructions 
cause a program interruption for monitoring to take place, provided that an inter- 
ruption is allowed for the monitor class specified by the instruction. Along with the 
interruption, the monitor class number and a monitor code are stored for subsequent 
use by the monitoring program. 

The instruction MONITOR CALL designates one of 16 monitoring classes together 
with a set of 16 monitor masks in a control register. One mask bit is associated 
with each class. The execution of the instruction causes a program interruption 
when the monitor-mask bit for the class specified in the instruction is one. The 
cause of the interruption is identified by setting bit 9 of the interruption code to 
one, and by the information placed at locations 148-149 and 156-159 of low 
address storage. 



The monitor-mask bits are in bit positions 16-31 of control register 8. 





MONITOR MASKS 



16 31 

The mask bits, in ascending order of bit positions, correspond to monitor classes 
0-15. Any number of monitor-mask bits may be on at any time; together they 
specify the classes of monitor events that are monitored at that time. The mask 
bits are initialized to zero. 



/^ppCiluiXCS, r-x..y 
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LINE MODE TABLE 



This table is built at supervisor generation time when the POWER=YES, TP=BTAM, 

QTAM, or VTAM parameter is included in the SUPVR macro, and M0DEL=1 15 or 

125. An entry is built for each device for which the DVCGEN macro includes the 

MODE=X'ssss' of X'ssssss' parameter. Each entry contains the actual mode setting 

for the device. 

This entry will only be generated for device type 2703, address X'020' - X'03F' 

inclusive. 



c 



"^. 



Number 

of 

start /stop 

lines 



Number 
of 

BSC 
lines 



Maximum 



MODTAB 



Maximum <; 






Actual < 



Actual <: 



x^ 



The first 4 bytes of the table 

Maximum number of start/stop lines. Sej by the lOTAB 
macro at system generation 

Maximum number of BSC lines. Set by the lOTAB macro 
at system generation 

Actual number of start/stop lines. Determined by DVCGEN 
macros at system generation and ADD commands at IPL 

Actual number of BSC lines. Determined by DVCGEN macro 
at system generation and ADD commands at IPL 



not used 



Line Mode settings for 
Models 115and 125 Comm. Adapter 



V.., 



Bytes 140-143 {X'8C'-X'8F') of the System Communication Region (SYSCOM) 
contain the address of the table. 

Label MODTAB identifies the first byte of the table 



Figure F.l Line Mode Table (LMT) 
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This appendix shows an example of the output obtained from a formatted stand- 
alone dump as generated by the IBM program DUMPGEN with the parameters 
FORMAT=YES and PPOOL=NO. 

Refer to Section 2-A-3 for a description of DUMPGEN and the stand-alone dump 
program. 

In a system dump output, the supervisor area dumped is almost identical to that 
dumped by the formatted stand-alone dump, the only difference being that a 
system dump does not divide the dump into blocks of 2K storage areas. Refer 
to Section 2-A-2 for a description of the system dump. 

The programmer's remarks on the dump example indicate how the various tables 
and information blocks are located by using addresses stored in the communication 
regions. The programmer has also indicated the meaning of several bytes on the 
dump, enabling a mental picture to be built up of the system status just before 
the dump program was executed. 

Following the last but one 2K block of real storage (246 in the example shown), 
the page status information and contents of the control registers is printed. In 
the example shown of a formatted dump, the control registers are followed by the 
communication regions. (This does not include the system communication region.) 

The remaining part of the example shows the order and format of the tables and 
information blocks printed in a formatted dump output. 

The last block to be printed is the SELECTION POOL, the contents of which are 
explained in a note at the end of the example. 

IMPORTANT NOTE 

The location and addresses of the table and information blocks shown in this 
example apply only to the system that produced this example. The actual location 
of areas indicated depends on the system generation options specified, and the 
program running in your system just before the dump program is executed. 
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Figure G.l An example of a formatted stand-alone dump output, part 1 of 20 
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Appendix G 



EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



~\ 






n07 



7B6CP F;".'ir6(;'V i);>C.)F3CV ;)5')5'.005 ,)6rj40C5 E7C^C?t'. tiCSMdll '.OtlOSAO C')|15<iOC9 

7B6En D'jofic? cioi40f-2 tJciE3e^ £^ciC4C'* oqcbt^.t?' cs!r.?4~c6 D6i)9<tDh? r.5C70'.ce. 

7B700 LJ5K^40E1 CIC^I)3C'j 40C9>5<tC C.iD')F140 ClD^C^^fO H2E<ilVCl Df.D'i'tOC'. nh'>C.lSD6 

rn720 tUOlJACl L'3C1CaC3 .)9Fl'iOCl D6,)t.l,: IC) DSE 3F^<.0 C<3E?'.f'tl C10^CS0'i <.Of1D6A0 

7B740 i)3i)6C;iCl fSC'.nti C^CS'i'lE;' Cit/D'tC) DiElAOU ClC2D.fC') C<)01C?t? C5C7H.^n 

7B760 ClJhiJSEI C505E?E2 ^ocqE^-iO FKD^CJ ()b'iOE3!)h '.OillObCl CltiC^'Vn EiCSCiAO 

7B78'^ F,'(;5C7D4 C5JSE340 E 3C IC ?!) 3 CSEJC^CT D4CSUSE3 '.OEJCIC^ D3C')<.0t3 ClU'jO'iDb 

B7A0 

B7C0 

B7E0 E?( 



C,i^ 



BLOCK I 

000000 
00002" 
00004Q 
000060 
00C080 
OOOOAC. 
OOOCO 
OOO'VAO 

ooo4cr 

OOO'tEO 

<5^' 000 500 

, OOO-iZO 

^000'5'VO 

000560 

0005'K) 

OOO-jAO 

0005C0 

0005E0 

000600 

000620 



0006C0 
0006EO 
000700 
0007'tO 
000760 
000780 
00O7A0 
000 7C0 
OOO7E0 



000800 
000820 
000840 
000860 
000880 
0008A0 
0008CO 

oooaEo 

000900 
000920 









0900A619 ?C 0r)004F OnOOOQCO OOOOOOOO 0007BOOO nr>0OC2A8| 1B4B4fiAE\ '.H'.B'fB^U 

07»D00n0 OrP<iW?)2 OOOC ^OOS 0-V)f'A64^ OCOOOOO "0000000 070F200'-\oO(,0090C 

" '' F'.0r.8900 02OAFE'5D l-OO8r0COp000A67E 

OOOCOOCO OO07U3AA COOaOC ((, p000AA7E 

A009J8'.Q 0002000 oGnQooooi-o^cooirx 



0007 )0 38 OROi OCr?0 
"40C0O'''O onoooBCc 
OOr'Ooa^o'^ OOOOuOOO 



0000000" 

0000000 ,AaUl*^ <f 

296 1472UV319 
•iS 300000 3rjCr. 3E'.C 
O10QP0O0 CAAinOEO 



0007(^.0 3i5 1 OOOOOOOO 

oror,oooo ooooa'jFO 

OP"2n07 C0040005 



Pc/B 






nOOOClOC 60'^C|OOOCJ oocooooo 




3FP0 3F06 pTEOCpi"' ■ 
3E3C001J '^^''0^^' A/Pfl/^rS 
00000588 OCOO -< 






pooo Jooco7orZ1 oooooooo 00008299 oof 

cr-.o (^'^•y ' '•'" y".,,^^p OOOOf 0<VI 0)( 

— ^0 00003A8C OC 



0032002C loop 
lOCOCOO' 



OOCOPOOC 1 01'. 11000 31 l 00C0E6'<51jOO00Dt8 8| 0000F2l>r |0CO06TfB 

-?^S-?2ir:22! .^-1 r 0000^92 opoc7oooo 1 000 iqqa 3 oi^^coco 



00000000 

O002OP08 
00830083 
00830083 
00004036 
00003EEO 
OOOOOOOO 
06B006BO 
95030585 



'tlBHOOlF 
937E9463 
07FE960C 
'H6008FC 
06B006B0 
30020787 
07F 74880 
072E94FE 
9500060E 
U9109000 



OOOOOOOO 
00020406 
— SAME — 
83838300 
00009260 
00100000 
00000680 
06I3006BO 
47700826 



07F6084r. OOuuuuuu 
080AOCOE 00183048 

OOOOOOOO OOOOOOOO 
OOCOOOOO OOOOOOOO 
00007118 00007100 
06B006B0 06800680 
068006B0 06B006B0 
459008C2 47E00326 









CPU. ID 



00000002 000UUU01 

00r;07288 10007340 

Q6B04880 06C206B0 

06B00680 06804188 001F41BB OOIOIRI 

06B006BO a6B006BO 06B006BO 06B006BO 



z"" ZK lAU </ A-^ii^^ 



06Bf!06H0 
3C0642B0 
AOOFAFOl 
07FF06B0 
06BC06H0 
18414340 
04CEa880 
058207F9 
47800A5A 
DO 1409 19 



41BB001B 
A00158B0 
01AE4400 
06B006B0 
06B0AF05 
30028940 
000 34 188 
4590C6C2 
AD03099C 
06C 04780 



45700896 
065C96aC 
897A077F 
06800680 
OU1050BO 
00035A40 
003B4188 
9283AOO0 
9 5000585 
09U61BAA 



58900554 
AOOFAFOl 
92n050F 
06800680 
00008200 
05641 8A1 
06C09283 
5880AO04 
47 700AA4 
60A005DC 



4ir09244 
01AE95 10 
92830741 
06 80 06 BO 
06581B11 
43A04007 
80009200 
50008030 
02 1009 ID 
ACFCU99C 



1211477C 

A00107BE 
92000599 
06B00680 
D3000680 
4AA004FA 
05859204 
9200HO3P 
D9324890 
43A10015 



s 

L<x«^ aclcUe^ ASftMB. 

u 

_— — To* A/** 



~~^8ii^ .0...: ; 

^ SXS//1/ 



syscoM 



/5W Ay^ 

'^ A<fu/ 



/ ^N 



082641F0 

AF050021 
45606814 
06B006BO 
300495FF 
58104000 
06899283 
92000689 
04FADC10 
42A00585 



Figure G.l An example of a formatted stand-alone dump output, part 2 of 20 
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EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



^V 



o^' 



oo; 0^ 

003BC0 
003BE0 
003C00 
003C20 
003M0 
003CCO 
003CE0 
003000 
003020 
003040 
003060 

003DAO 
0030CO 



r^ ^ mi Myy ^ af 



60000004 0800ETE8 OOOOOAOl 
C2C4E404 07401700 000070AO 

000 



QOOQOOOO 00000000 OCOOQi 
Jp4»0OOOOOOOZ0O0BO0000i 



0000000<» C>4A(g )000 00020007 00000000 00100000 .45900036 00020007 00000000 

00000000 00000000 00000000 OOOOOOOQ OOOOOOOoU oOO fclOST OOOOOOOO O00Q63E8 
'■^M aiifititJ iiO'tOOOO OOOO6458 OQOE2880 8200C6F4 80061000 00006518 



OOOE 

80441E80 8000C6F3 80007800 000065D8 

mm mm\ nun mitui 

00000000 80000000 00000000 00006A58 
00000 00000000 00006808 
00000000 SOOd^QPO 00000000 00006058 
OOOOOOOQ 00006ED8 



900fi 



00000000 80000000 00000000 00006998 
00000000 80000000 00000000 00006B18 
00000000 80000000 00000000 00006C98 

9900|£ia 

00000000 



00000000 80OQO0OQ OQOQOQOg 
00000000 l OOQOQOQO 00000000 



fV 



c^' 



'Tr03FO0= 
003F20 
003F40 
003P60 
003F80 
003FAO 
003FCO 
O03FE0 



o 



•qC' 



M'^fi 



BLOCK 0( 8 



004000 
004020 
004040 
004060 
004080 
0040 AO 
0040 CO 
OOiflEO, 

tfimoF 

004120 
004140 
004160 
004180 
I aO41A0 
041CO 

\ 004240 
/004260 
004280 
0042AO 
0O42C0 
0042E0 
004300 
004320 
004340 
004360 
004380 
0043A0 
0043C0 
0043EO 
004400 
004420 
004440 
004460 
004480 
0044A0 
0044C0 
0044E0 
004500 
004520 
004540 
004S60 
004S80 
OO45A0 
0045C0 
0045EO 
004600 
004620 
004640 
004660 
004680 
0046AO 
0046C0 
0046E0 
004700 
004720 
004740 
004760 
004780 
0047A0 
0047C0 
0047E0 



02FF03FF OOFF 
OBFFFFFF FFFFF 



IFF0702 06FF06FF Q6Q4 FFFF 
FFFpF FFFFFFFF^FFFFFFFF 



rrrrrrrr crrrrrrr orrrritTr 12ffoeff 

FFFFF FFFF07FF 07FF07FF FFFFFFFF 



FFFFFFFF FFFFFFFF OOFFFFFF 



OBFFFFFF 07FI 



FFFFFFF FFFFFFFF FFFFFFFF FFFFFM 



FFFFFFFF FFFFFFFF 
FFFFFFFF FFFFFFFF 
07FFFFFF 07FF0708 
FFFFFFFF — SAME— 
FFFFFFFF FFFFFFFF 
FFFFFFFF — SAME— 



FFFFFFFF FFFFFFFF FFFFFFFF FFFFFFFF 
lOFFlOFF 14FF15FF 0OFF07FF 06FF0606 
07090707 07FFFFFF FFFFFFFF FFFFFFFF 



FFFFFFFF FFFFFFFF 
OBFFFFFF 07FFFFFF 
FFFFFFFF FFFFFFFF 



/>fl|A6«& 



)BFFFFFF 07FFFFFF 07FFFFFF FFFFFFFF 



FFFFFFF FFFFFFF 



■^UFFFFFFU g 
5gc3 O-^f 



Ioool,^^uu 



iimom JimfMi,^ 

110000F8 OOUUFI^bo 

.IFFOO 

031 

FFQOOOOO 
FFOOOOOO 



I013OFFO0 
'40F0< 



<<?«W '^ Cgm *«^ ^ ,co oiMFFaO 



?i0666f& 

620002F8 
620402F8 
50C300C0 



6 20000F8 
OOP0050 



0131FF00 
O26OFF0O 
OZAgFFOO 
I5|81FF0' " 



00000000 
00000002 

m 



000 
00020008 



uisFFOB 
OOOOOSOO 
00001300 
OOOOIBOO 
00002300 
00002800 
00003300 
00003BOO 

gflffMM 



FF80fF44 
OOOOOCOO 
00001400 
OOOOICOO 
00002400 
OO002C00 
00003400 
OOOOFFOO 



00010001 
00000002 



00010000 
0OO10O08 



OOOOOOOB 
00080000 



OOOOODOO 
00001500 
OOOOlDOO 
0000Z500 
00002000 
00003500 



0G0OOA67 
OOOOOEOO 
00001600 
OOOOIEOO 
00002600 
0O0O2E00 
00003600 



m 



OOOOOFOO 
00001700 
OOOOIFOO 
00002700 
00002F00 
00003700 
000000 



00000000 
OOOBFFFF 
F2F0F6F7 
OQ00806C 
40404040 



8ar 

FD7FCED3 
F3F3F4F0 
000073F8 
40404000 



00000000 
OOOBFFFF 
F2F0F6F7 
00008075 



00000000 
OOOBFFFF 
F2F0F6F7 
0000807E 
40404040 



oododobd 

F07FCE03 
F3F3F4F0 
00007340 
40404000 



0OOOCE5O 
00003C04 
00003864 
40404040 



6656566^ 

FD7FCED3 
F3F3F4F0 
00007288 
40404000 



30804EOO 
00003C04 
00003864 
40404040 



002E4OF0 
0000003C 
3BD45A30 
40404001 



J F1F261F0 
00000000 
41044296 
48100000 



9C28FF15 

00001000 
00001800 
00002000 
00002800 
00003000 
00003800 
OOFFOOOO 



9C2eFF15 
00001100 
00001900 
00002100 
00002900 
00003100 
00003900 
OOOOOOFF 



9C28FF0O 
00001200 
OOOOIAOO 
00002200 
00002AOO 
00003200 
00003A0O 



J-PIB; 









00000000 
OOOBFFFF 
F2F0F6F7 
00008087 
40404040 



00000000 
00000000 
00790000 
00000019 
00000000 
00510000 
00000013 
00000000 
00500000 
00000019 
00000000 
FFOOOOOO 
00000019 
00000000 



65d66AAA 

F07FCE03 
F3F3F4F0 
000071DO 
40404000 



0O0OCE50 
00003CD4 
00003864 
40404040 



002E40F0 
0000003C 
3B045A30 
40404000 



OOOAIFFF 
41044296 
479B0O0O 



F661F7F3 
OOOOOOOO 
42974389 
30CC3E4C 
04A010EO 0000058 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 



00000050 
3F0C38F1 
00000050 



0008AFF6 
42974389 
30CC3E4C 



tmrn 

0008D40F 
3Fd03F06 
3EBC0010 



•mmss 

00000040 
3F0C38FI 
00000040 



00855665 

OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
O3Ee0O0O 
OOOOOOFF 
OOOOOOOO 
03E 80000 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



3O0OCED2 
00003CD4 
00003864 
40404040 



0O2E4OF0 
0000003C 
3B045A30 
40404000 



J FiF261F0 
OOOOOOOO 
41044296 
47200000 
10000000 



Tmsuror 

002E40F0 
0000003C 
3B045A30 



PlFJ6if5 
00074FFF 
41044296 
46A80000 
OOOOOOOO 



F661F7F3 
OOOOOOOO 
42974389 
30CC3E4C 
QES. 



m 



65555556 

00510000 
00000013 
OOOOOOOO 
00500000 
00000019 
OOOOOOOO 
FFOOOOOO 
00000019 
OOOOOOOO 
00500000 
OOOOOOOO 
OOOOOOOO 
00790000 



55555565 

OOOOOOOO 
03E 80000 
OOOOOOFF 
OOOOOOOO 
03E 80000 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



' 85506880 

00500000 
00000019 
OOOOOOOO 
FFOOOOOO 
00000019 
OOOOOOOO 
00500000 
OOOOOOOO 
OOOOOOOO 
00790000 
00000019 
OOOOOOOO 
00510000 
00000013 



F661F7F3 
00063CSB 
42974389 
30CC3E4C 
04A010EO 



70067000 
OOOOOOOO 
3F003F06 
3EBC0010 
000! 



OOOOOOOO 
03E8OO00 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
03 E 80000 



70007000 
OOOOOOOO 
3F003F06 
3EBC0010 
00000588 



OOOOOOOO 
00000030 
3F0C38F1 
00000030 

sasmm. 



wsmm- 

00000019 
OOOOOOOO 
00500000 
OOOOOOOO 
OOOOOOOO 
00790000 
00000019 
OOOOOOOO 
00510000 
00000013 
OOOOOOOO 
OOSOOOOO 
00000019 
OOOOOOOO 



OOOOOOOO 
00000020 
3F0C38F1 
00000020 
COCOO04O 



T5TO 

OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
03E 80000 
OOOOOOFF 
OOOOOOOO 
03E80000 
OOOOOOOO 



S At It/A xm,;/ 4^ A/t 2^J/6 



■/=<?c 






^PUB 



o 
s 

Z ^ . . B 
3 « . • /« 

e„4^ in T/S ' S 
V-TfB ^ 



TU 



F1 



06/73 

....c 

1 



06/73.... 
....6..M. 



ifk (kensloo^ / 
<armi^^"'* 



BLOCK 009 

004800 OOSOOOOO! OOOOOOOO 00000019 OOOOOOOO OOOOOOOO OOOOOOFF FFOOOOOO OOOOOOOO 



%J 
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EXAMPLE OF A 
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DUMP OUTPUT 



( 



J 



005D80 
0050A0 
0050C0 
0050EO 
005E00 
005E20 
005E40 
O0SE60 
005E80 
005EA0 
005ECO 
OOSEEO 
OO5F0O 
0051=20 
005F40 
005F60 
005F80 
005FA0 
005FC0 
005FE0 



ocvs^rao 

96207003 
90001000 



E4724B60 06E25060 00484166 00080300 
92036000 47F0E3e6 D207E23C 0040D203 
472C.E56C 4710E472 91020044 4710E472 



7798203* 
E680203A 
OOOOFFOi 
OOOOFF 
OOOOF/00 
OOOOfFOO 
OOOOfFOO 
OOOOkFOO 
OOOOF 
OOOOFFOl 
OOOOFFOO 
OOQFFOO 




i66 Ti!.e»B?A OAFFflflOO 



04FF 
"ODOO' OOOOFFOO FFFFOEOO 



rsvmrr 

004 0410b o00 7730203A 

ro*«« : 



0048 E2 15 
0048E230_ 
5060i 



CO a cu,4J^ « f'fos^ 



FFFF3100 OOOOFFOO FFFFFFOO 



300FF00 



flflflflflofla flgflBflfloo flflflwaofl mm^m > — vmm^ 

00000000 bOOOOOOO 05000000 OOOOOOOO 00000000 
07000000 OOOOOOOO OOOOOOOO 08000000 OOOOOOOO 
OOOOOOOO OAOOOOOO OOOOOOOO OOOOOOOO OBOOOOOO 



04FFOBOO 

04FF0900 

FFFFOFOO 

"FF1300 

=FF1700 

=FF1B00 

=FF1F00 

FFFF2300 

FFFF2700 

•='^FF2B00 

FtP?^ 
OOOOOOOO 
06000000 
OOOOOOOO 
OOOOOOOO 



96407000 

.5j a 'jt) U5U " 

D300004B 



39A0033C 
78D0203A 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 
OOOOFFOO 



06FFFFOO 
04FFOCOO 
FFFFIOOO 
FFFF1400 
FFFF1800 
FFFFICOO 
FFFF2000 
FFFF2400 
FFFF2800 
FFFF2C00 



OOOOOOOO 
OOOOOOOO 
09000000 
OOOOOOOO 



m 



04000000 
OOOOOOOO 
OOOOOOOO 
OCOOOOOO 



CHftNQ 



. K...S....E.... 
-.ii-i: 1 ^.«. 

OZ , ukceA tn cA«Unjea^ \ 
-* OS -^ OC S-A'A 



BLOCK 012 



006000 
006020 
006040 
006060 
006080 
0060AO 
0060C0 
OO&OEO 
006140 
006160 
006300 
006320 
006340 
006360 
006380 
0063A0 
006 3G0 
OO63E0 
006400 
006420 
006440 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OFOOOOOO OOOOOOOO OOOOOOOO 10000000 

ioooog^_ii>uiniMiiiir 

-nodttOi- "•'FUOOO OOOOFFOO 
lOOOOOO FFOOOOOO 
lOOFFOO OOOOOOFF 
1000000 OOOOOOOO 



/-/%«« 

//r^/ 



-5<C//^^c? 



OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
007A0013 

Ji poooooo 



--SAME— 
00000000 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 



00040000 
00061000 
00089000 



00000E74 
O00O86BB 
00089000 
OOOOOOOO 



666e6B60 

00075000 
OO0A2O0O 



1000E600 
OOOOOOOO 
00200040 
OOOOOOOO 



aiaapiFi 

000084BA 
FFFF7D18 
— SAME — 



B6B1 T 866 

00021000 
00027000 



OAOOOOOO 

OOOOOOOO 
OOOOOOOO 

OOOOOOOO 



OOOOOOOO OEOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO QOQOOOOO 1 1000000 OOOOOOOO 
~ 3000000 OOOOOOOfl DW>e<Ul80 FFOOOOOO 
00000(r~»0€FOOOO 
OOOOFF 000 
j^Ola^ <^ C/t/C<j^ 000000 200020(5^ 
( 000000 OOOOOOOO 

410C0400 OOOOOOOO OOO0E7E8 10000000 
OOOOOOOO 4000E9CO 0E000005 00000400 
OOOOOOOO 00000000.00000000 OOOOOOOO 



' sB5Bti£3 espweii;pc2UAc h^f>iini laaaaaaaa aaaaaaaa aaa^^m 60000006 ' 




npi F i F i 

00008534 
00008340 



Baai g gaa 

00023800 
0002A800 



OOOOOOOO l'oo66a688l 6a63B6BB oaaSBB^^ 

00046600 00061000 0001E800 00021000 



aaaae^se 

8000837A 
00008660 



00075000 00089000 00023800 00027000 
?S9f?9P? OOOCOOOOI 01310000 OOOOOEIO 



TSTBUTTOSTBSirS^STooooBSDS oooo84CA 

000082E8 00008318 00008308 00089040 
00004450 OOOOOOOO OOOOOOOO OOOOOOOO 






v_ 



./ 




STAfif 



009 3C0 
OO93E0 
COO'iOft- 



F2F3F4F5 F6F7F8F" 



r^r•>r■^rb r%ri.rir\ 



'>=-3C5D3 C9C7D5D6 



pDoM 



009480 
0094A0 
0094C0 
0094E0 
009500 
009 5Z0 
009540 
C09560 
009580 
O095A0 
009 5C0 
009 5E0 
009600 
C09620 
009640 
009660 
009680 
009 7E0 



40404300 C10940' f^ Ao^/h*) o/ ^P a/«9 50000 o6pooooo /t^wt* o/ <u£ix, /V/^/^ 

n n nnnnnn n AM r . ' i., . "^ ( ' . 

OOOOOOOO O0OO00O0 l00aa?9?F)l O00O479C 00001666 OO0OB44y 0O000C56 00009F02 
00000330 00004798 0030TWy 00001000 ^D7:4:iC9 C4C7E3E51 FFFF3009 FF'^FFFF 



"45i7e9ABC0EFCA NCELIGNORE 



30 ^D7:4C 



FFFFFFFF [o6o3D80OirO003FFFO | 3FDE , 

47109i«/€<«, ^-"^ 

D20193(A viuAvus/ Vi<:u'*5Fh vu.lC 

1B651876 1B665060 910C4C70 910E 

985791 JO 47F091CC 41509120 5869 

9C6CA000 OOOOOOOO OOOOOOOO 0000 
00003330 — SAME — 

OCOOOOOO OOOOOOOO OOOOOOOO 0000 



^F FFFFFFFF FFFFFFFF 0003FFF0 

>0 42C0910B 58C00080 9Sa0C045 

JB 078A95FF 910B078* 95FF910B 

=F 60004783 93CA0500 80030063 

ro 91160207 70000020 90017008 

31 70108002 41770012 5970911C 

10 00000001 OOOOOOOO 0003 0600 

>0 90839049 02009089 904AD200 

=0 909F47FO 917090CA 91809058 

JO 928090C7 95009070 4770917E 

iO 903:5860 90433203 905*9040 

f5 50509114 50509118 5070911C 

, .0 eoo-^niw ■^■..,^^-^^ j.-»,047F3 

30 OOOOOOOO OOOOOOOO OOOOOOOO 



[POAIDGTW ^. 
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EXAMPLE OF A 
STAND ALONE 
DUMP OUTPUT 



00DE40 
000660 
00OE8O 
OOOEAO 
OOOECO 
OOOEEO 
OOOFOO 
00DF20 
OODF'.O 
OOOF50 
OODF80 
OODFAO 
OOOFCO 
OODFEO 



OQEOOO 
OOE020 
00E040 
00E060 
00E080 
QOEOAO 
OOEOCO 
OOEOEO 
OOEIOO 
00E120 
OOEWO 
00E160 
00E180 
OOEIAO 
OOEICO 
OOEIEO 
O0E20O 
00E220 
00E24O 
0OE260 
00E2B0 
00E2A0 
00E2C0 
00E32O 
00E340 
00E360 
00E380 
00E3A0 
00E3C0 
00E3E0 
00E420 
OOE'^40 
00E4A0 
00E4C0 
Q0E4E0 
OOE500 
00E520 
00E540 
OOF 560 
00E580 
00E5A0 
00E5C0 

|00E64O 
'0OE66O 
00E680 
00E6A0 
00E6CO 
00E6E0 
OOE700 
00E720 
00E740 
00E760 
00E78O 
00E7A0 
0OE7CO 
00E7EO 



00 E 800 
00E820 
O0E84d 
O0E86O 
00E880 
00E8A0 
00E8C0 
00E8E0 
OOE900 
00E920 
00E940 
00E960 
O0E980 



F0109200 
00000000 
00000000 



00020000 
00020000 
00020000 
00020000 
000 20000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 



F7485870 F6E407F7 96 
— SAME — 

00000000 



0CO3000O 
00070000 
OOOBOOOO 
OOOFOOOO 
00130000 
00170000 
00180000 
OOIFOOOO 
00230000 
00270000 
0O2BO0OO 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 






*«<?<: 



OOQOOOOO 00000000 



,..7...6li.T..6H .7. 



(5flOW80fl 

00080000 

ooocoooo 

00100000 
00140000 
00180000 
OOICOOOO 
00200000 
00240000 
00280000 
002C0000 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
'00020000 



500500001 
00050066 
00090000 
00000000 
00110000 
00150000 
00190000 
00100000 
00210000 
00250000 
00290000 

§023)0000; 



/>fr /^^/iM£ 7^3 



002201F8 

000002AO 
00000 ICO 
00000100 
00000200 
OOOOOIBO 
00000410 
00000298 
00000280 
00000220 



00820268 
00810268 
OOC70418 
00C40208 
013901F0 
013102B0 
01130290 
01160230 
01300270 
011A0258 



00220260 
00000210 
000001A8 
OOOOOIAO 
00000228 
00000248 
00000188 
00000270 
00000288 
00000190 



00830410 
FFFFOIEO 
00C601B8 
FFFF0170 
013A01F8 
01190298 
01170248 
013F0410 
01410278 
00C80198 



00000208 00840240' 
00000250 O0C5O1C0 
002202AO O0C20190 
00000268 013701B0 
00000108 00800188 
00000290 01120200 
00000240 01180220 
00000198 013501E8 
000002A8 01400280 
000002BO 01420288 



00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
00020000 
OOOOOIEO 



OOOOOIFO 
00066 lES' 
00000418 
000001F8 
000002B8 
00000258 
00000230 
00000278 
00000238 
00000218 



00020000 
00060000 
OOOAOOOO 
OOOEOOOO 
00120000 
00160000 
OOIAOOOO 
00160000 
00220000 
OOZ60O0O 
002AOOOO 
FFFF0400 



013B02A0 
"0136'd2i8 
OOC30108 
01380190 
FFFFOIAO 
01150250 
011401A8 
013E0260 
013CO228 
014302A8 



000002C0 FFFF0210 000002C8 FFFF02B8 

000002EO FFFFO2D0 000002E8 FFFF02D8 

00000300 FFFFC 

00000320 FFFF( 

00000340 FFFFC /YXC /Ul^ -fpx^HJu) 

00000360 FFFFC 

00000380 FFFFC 

000003AO FFFF039O 000003A8 FFFF0398 

000003CO FFFFO3B0 000003C8 FFFF03B8 



/IZt ^^UlAii. -m»,>ui^ c^nMA£</ 



000002DO FFFF02C0 000002D8 FFFF02C8 

000002F0 FFFF02E0 000002F8 FFFF0ZE8 

00 00000318 FFFF0308 

20 00000338 FFFF0328 

40 00000358 FFFF0348 

60 00000378 FFFF0368 

80 00000398 FFFF0388 

000003BO FFFF03A0 000003B8 FFFF03A8 

00000300 FFFF03C0 00000400 FFFF03Ce 



000303E0 
00030400 

• ficaooiBg 



007B03DO 000303E8 007C03DO 



00000000 
00000000 
00400048 
00C000C8 
01400148 



00500058 00600068 00700078^ 
00D000D8 00E000E8 00FOOQF8 



«ni 1801 t 

p/?c?e- 



01500158 016001681 801J>^ 1 1 
801 I 8011 BOl 18021 M218021 
Tfi^i-E 1^0518051 






00000000 00000000 00000000 00000000 



00800088 00900098 00A000A8 O0BOOOB8 
1 000108 01100118 0120012B 01300138 



B00103D9 03E 
— SAME 
00150015 
0025002, 



S3E9 03F103F9 



150015 00150015 

00250025 00250025 



35 00350035 00350035 



80018001 

00150015 

00150015 

02A10025 

00250025 

00250025 0035,, 

00350035 

00350035 

02490221 

00450045y 

OIFIOIF 

00550(1/55 

0055085^ U U95UU5 5 00550055 00550055 

?i;7 gE33gr fao6£i7o rooog^Bo FaoaE^ra 

F000E530 FOOOE570 F000E5B0 F00065F0 

~ floaaiJaB^ aaaaegjfl oaa^isia ' 



20*0 1790 nsoo /8000'ffoo^^^^ - 
I 0179)0181 1 oias| o5i5 



fyouj^^^ <^ 



3035 
3045 
3045 
3261 



01C901D1 010901A9 01C101B9 
00250025 00250025 00250025 



00350035 00350035 00350035 00350035 



00350035 02290239 02510231 02590241 






~~~~ S/uxod 






I i^^ft'l^ 



ofiaaaaee 

O0OOE83O 
00000000 
06023D50 
80000000 



00000000 00000000 oooooooo 

00O0E9O8 0702301C 60000006 

600000A0 92023038 20000005 

00089CEO 88000000 000OE998 



\ n6eAZJJd^S£fyifeA/T ^ 

oqoolti iQD oooooooy oooooooo oooooooo 
~TO^E43 oTF566£^7a \(>btlKU tbbbi.>.lh\ -\ . ^„ 

rrrOTo&wn- aaaaaaai aaaaaaai oooc^oooi ' p Sfcfwrwr 

oooooooo oooooooo OO2OCOO0 000614E8 T/')BL£' 



-'■- ¥7 — . - /7^oO 



oooooooo oooooooo oooooooo oooooooo 

31023D1E 60000005 O8O0E6D0 OOOOOOOO 



oooooooo 

OOOOOOOO 

• gsda^aaa 

OOOOOOOO 
00008000 
0000E6C8 

oooooooo 



— SAME- 

00000000 80000000 00041770 



J 88000000 



]] 2' 



ccw Copy block 






'/e y^^ 



B9B1?FU^ 



DOOOZF! 



CCS A<rOn^ 

" c/ffifi/4 e^ f 






09mi 

OOOOOOOO oooooooo 89<500000 

oooooooo — SAME — 

oooooooo oooooooo /Oooooooo 

00008000 OCOO2OO3/0OOOE758 



09018033 60000021 09018054 60000020 

"a4arc9AE ioaoooBP mxthu 66000003 

oooooooo oooooooo oooooooo oooooooo 

poof^nnnn n/io/>nnr>o ic^„.:<.-.„ »000005A 

CCW Copy 01OCK ^-'-'^ 300E3CO 

^ 3089030 



Pi CCW 



copy BLOCK 



CCV/ <zoic^-»u!> in C%W 



00000000\ 
OOOOOOOO 



fi CCB Co/>y Bix>c.K 



■Xl>/IL 3<.ocK 
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B^HHHII 






^ BLOCK 047 














01T800 


4O40D440 40404040 C104E240 40404040 40404040 


40404040 4040C340 


7E4004C9 


n AMS 


C . NI 






« 017820 


D5C4C5D9 40C2C5D3 C1D5C7D9 €9010246 40E5C509 


C4C5D9C5 4006D5E3 


E6C902D2 


NOER BELANGRIJK. 


VEROERE ONTWIKK 






• 017B40 


CSD3C9D5 C740E5C1 D540E2C9 E3E4C1E3 C9C540D4 


06C5E340 C1C6C7C5 


E6C1C3C8 


ELING VAN SITUAT 


IE nOET AF6EMACH 






017860 


E340 140 


D5C9C5E3 40E5C509 


0605E309 


T MOROEN . .N 


OG. NIET VERONTR 






_ 017880 


E4E2 >06 


D9C4E340 C7C5C505 


40C102E3 


USTENO. VOORLOPI 


G WOROT GEEN AKT 






• 0178A0 


C9C5 )40 


40404040 40404040 


40404040 


IE ONDERNOMEN 








0178CO 
_ 017960 


wXo FUB 00 <MlM/Jl^ CLe^^*^^ QOOf ;4o 


40404040 40404040 


40404040 


•* AFK0RTIN6EN 


•• 






• 017980 
017A20 


^to <'<W«' ^^ 00 -- fifi-H/S , A** HO 
0703 DUU4, O'Tu/ pueuM ^ Cfi'/f/yQ ,09 


ES060609 030607C9 


C75040C1 




* .VO0RL0PI6. A 






^ 017A40 


05E3C9CS 40400703 


E3407E40 


FGEMERKT UGN . 


URGENTie PLT . 






• 017A60 


C7C505E3 C9C5C306 


C4CS7A40 


PLAATS 


URGENT I ECDOE. 






017A80 


♦0404040 4040C140 


7E40C8D6 




A . HO 






^ 017AA0 


03D3C9D1 02C540C1 


D2E3C9CS 


OGST URGENT. ONN 


lODELLIJKE AKTIE 






-• 017AC0 


C9D5 (fi^m ceo m^44*i/t A. C/('/tMf)'^?''SMO 
0000 /ff^e4€4^ f^ /'^ ^<^*^ ^^^ St.oct< 
Zll (/^ CC^ cc^y acoat)^ £7^^ ]ll 


40404040 40404040 


40404040 


VEREIST 








017AE0 


D9C90102 4B40C102 


E3C9C540 


B . BE 


LANGRIJK. AKTIE 






— 017BOO 


40404040 40404040 


40404040 


IN NABIJE TOEKOM 


ST 






• 017B20 


40404040 40000000 


00000000 










017840 






.... 








^ 017E60 
• 017E80 


0000005C 00000000 
O0O0012C 8004033C 


OOOOOOOC 
00000000 










O17EA0 
^ 017EE0 


0000 A<Jch**^ ^ //O aih*^(-f4t>^ /"' )F6 

4040 cct^J- '/yf^iriK' ' >oo 

1780 -yuV • — / '00 
0904 ^li*^ Of X/O Oy^e^ rF3 
0904., . V-.-,< .., _^ .. .-<574 

E3C9E5tp '*040«0401E2C503CS C3E3*0C1 ^0C2E4C7 


404040F1 404040F5 


404040FO 


TONS 12 


6 15 






• 017FOO 


04000000 00040004 


17380004 


21 33ANSTER0A 


N 






017F20 
_ 017F40 


00000000 09041788 
6000001F 09041812 


600000 IC 
60000021 


'.,'..-'. J... '.X^.W 


."".3-":: III-": 






• 017F60 

017F80 

_ 017FA0 


&0000020 09041894 
D94009D6 E4E3C905 
40C2Ee'iO C505E3C5 


20000025 
C540C1C3 
09C9D5C7 


....^... ....''•»# 


• •••^«»w»«««t««*» 




^...../JiuiTSEHr 


AATM ROUTINE AC 


' TIVE! SELECT A 


BUG BY ENTER INC 




• 017FCO 


40060SCS 40404040/06C640E3 C8C540C6 D6D30306 


E6C9D5C7 4003C5E3 


E3C509E2 


ONE OF THE F 


OLLOMING LETTERS 






017FE0 


40C60603/d306E6C5/c440C2EB 40C506C2 4B404040 


40404003 40404DC5 


D5E3C509 
/'^ CCH/- 


FOLLOMED BY EOB 


L .ENTER 






BLOCK 048 














^^^^^018000 


40C1D540 E405C5D5 C4C905C7 40030606 07504040 


4040C940 40400709 


D6C4E4C3 


-*-..-!*f?f°l!*''-!-°° 


r.: L •'';°°i?yfA-A'7*7jW 
















■ 



V:y 



03FOC0 
03FOE0 
03FE00 
03FE20 
03FE40 
03FE60 
03FE8O 
03FEA0 
03FEC0 
03FEE0 
03FF00 
03FF20 
03FF40 
03FF60 
03FF80 
03FFA0 
03FFC0 
03FFE0 



C6F 20740 
00089024 
00089A7C 
00089B58 
07402000 
9D24C6F2 
9A7C0708 
9B620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089BS8 
07402000 
9024C6F2 
9A7C0708 
9B620008 
00000000 



00000008 
C6F2074D 
00089024 
00089A7C 
00089658 
07402000 
9024C6F2 
9A7C07O8 
9B620OO8 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
07402000 
9024C6F2 
9A7C0708 
OOOOOOOO 



98620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
07402000 
9024C6F2 
9A7C0708 
9B620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089B58 
074D2000 
9D24C6F2 
OOOOOOOO 



9A7C0708 
98620008 
00000008 
C6F2074D 
00089024 
00089A7C 
000S9B58 
074D2000 
9D24C6F2 
9A7C070a 
9B620008 
00000008 
C6F2074D 
00089024 
00089A7C 
00089BS8 
07402000 
OOOOOOOO 



9D24C6F2 07402000 00089B58 00089A7C 
9A7C0708 9D24C6F2 07402000 00089B58 

/^ S(k. /^^/^ ^S/C /fu^ji. 

w\)afU£H i,oi->:u/tu uuuuuuub vb<><;uuu8 
00089A7C 00089024 C6F2074D 00000008 
00089B58 00089A7C 00089024 C6F20000 
OOOOOOOO OOOOOOOO OOOOOOOO oooooo|ool 



F2II! 




.F2 








..F2. 


.F2 

F2. 










F2... 








...F2... 










..F2. 








.F2 

F2. 






........ 











040000 OOOOOOOO OOOOOOOO OOOOl 

040020 ~SAME~ 

0407E0 OOOOOOOO OOOOOOOO 0000( 



BLOCK 129 



ana/ ZM ■e^t^ o^ 



00 OOOOOOOO 



00 OOOOOOOO 






(li. 



CfU 



040800 OOOOOOOO OOOOOOOO OOOOl 

040820 — SAME— 

O4OFE0 OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



AMfl^) 



00 OOOOOOOO 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



041000 OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
041020 —SANE — 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
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■■■1 


m 




HHH 










IMSEGT CONTENTS IS TAKEN TO LOCATE THE SEGMENT TABLE 


■ 






VIRT.AODR 


REAL ADOft 


BLOCK 


STATUS 




H 






r~ OOOOOO 


OOOOOO 


000 


CHANGED "N 
CHANGED 




^H 






000800 


000800 


001 




^^1 






001000 


001000 


002 


CHANGED 




^^1 






001800 


001800 


003 


UNCHANGED 




^^1 






002000 


002000 


004 


CHANGED 




^^1 




i 


002800 


002800 


005 


CHANGED 




^^B 






003000 


003000 


006 


UNCHANGED 




^^B 






003800 


003800 


007 


CHANGED 




^^B 




i 


004000 


004000 


008 


CHANGED 




^^B 






OOV800 


004800 


009 


CHANGED 




^^B 






005000 


005000 


010 


CHANGED 




^^B 






005800 


005800 


Oil 


CHANGED 




^^H 






006000 


006000 


012 


CHANGED 




^^1 






006800 


006800 


013 


UNCHANGED 




^^1 




•jTc 


L OOTOOO 

jjt 007800 

•^ 008000 

) 008800 

009000 

009800 


OOTOOr 
007800 
008000 
008800 
009000 
009800 


014 
015 
016 
017 
018 
019 


CHANGED 
CHANGED 
CHANGED 
CHANGED 
CHANGED 
UNCHANCED 




1 






OOAOOO 


OOAOOO 


020 


CHANGED 




^^1 






OOASOO 


O0A8O0 


021 


CHANGED 




^^B 






OOBOOO 


OOBOOO 


022 


CHANGED 




^^P 






00B800 


O0B8O0 


023 


CHANGED 




^^K 






OOCOOO 


OOCOOO 


024 


CHANGED 




^^H 




• 


OOC800 


ooceoo 


025 


CHANGED 




^^B 






OOOOOO 


OOOOOO 


026 


CHANGED 




^^P 






000800 


000800 


027 


CHANGED 




^^B 






OOEOOO 


OOEOOO 


028 


CHANGED 




^^B 






00E800 


OOEBOO 


029 


CHANGED 


1 


^^B 






OOFOOO 


OOFOOO 


030 


CHANGED / 




^^P 




_j 


OOF800 


00F800 
010000 


031 
032 


CHANGED / 
CHANGED \ 




■ 




010000 




• 


010800 


010800 


033 


CHANGED 




^^1 




i 


011000 


011000 


034 


CHANGED 




^^1 




^ 


011800 


011800 


035 


CHANGED 




^^B 






012000 


012000 


036 


CHANGED 




^^B 




9 


012800 
013000 
013800 
014000 
014800 
015000 


012800 
013000 
013800 
014000 
014800 
015000 


037 
038 
039 
040 
041 
042 


CHANGED 
CHANGED 
CHANGED 
CHANGED 
CHANGED 
CHANGED 




1 




# ; 


015800 
016000 
016800 


015800 
016000 
016800 


043 
044 
045 


CHANGED 
CHANGED 
CHANGED / 


)//<, AyXA /f9tn S«^^t.«»^* ^ .'V^yiMtvz.'i^ y 


1 




(^ A^«^ U /.«*//»-<&^ 






030800 


030800 


123 


CHANGED ^ 


^^^1 




# 


03E000 
03E800 
03F000 
03F800 


03E000 
03E800 
03F000 
03F800 


124 
125 
126 
127 


CHANGED I 
CHANGED / 
CHANGED 
CHANGED J 




1 




• 1 


040000 
040800 
041000 
041800 
042000 


020800 
019800 
017800 
018000 
018800 


065 
051 
047 
048 
049 


CHANGED 
CHANGED 
CHANGED r 
CHANGED \ 
CHANGED y 


.f jMS'J^v^'Vu/' S ' (fx //OKU 


1 




• ; 


061000 


01C800 


057 


I 

CHANGED ^ 


1 




3^ [__ 


... . 06180a. _ 


..oiopoo 


058 


CHANGED V 


^^1 




Hi 


HHI 


IBl 




HHM 




1 
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O96800 


027800 


079 


UNCHANGED 


d'FOOO 


027000 


078 


UNCHANGED 


09F8O0 


026000 


076 


UNCHANGED 



STORE STATUS FUNCTION NOT EXECUTED, CR IN INITIAL STATUS 



d 



OAOOOO 028800 

OAOeOO 028000 

OAIOOO 02A800 

A1800I 028000 



081 CHANGED 

080 CHANGED 

085 UNCHANGED 

086 UNCHANGED 






CR 0-7 OOOOOOEO OOOOOOOO FFFFFFFF FFFFFFFF 
CR 8-F OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 



OOOOOOOO OOOOOOOO OOOOOOOO OOOOOOOO 
OOOOOOOO OOOOOOOO CZOOOOOO 00000200 



fy //I Kr^ 





m 




^HH||[M 


HHH 




HHHHHHH 




■ 






PARTITION SAVE AREA 










I 






BG PSW- 


•071000000004038A 










^H 






REG 


9-0 00000006 OOOOOOOA 


4004007A 0004107A 


D7C8C1E2 90040206 00041ED8 


00040C59 




^H 






REG 


1-8 00041712 00000021 


00000061 00000010 


00000001 oooooooi oonooooi 


OOOOOOOO "*— ^^^^^ 




^^B 






F4 PSH 


-070D000000061CC6 






"3 M/-£^,^n^ 


a<:^^*'^- 


H 






REG 


9-0 eOO62A60 50061FFA 


00061088 00062888 


00063888 00004590 00000025 


00000003 ,____--'^ , / 




^H 






REG 


1-8 000614Ea 00004104 


00061106 00063A92 


OOOOOOOO 00004254 A0061A2E 


B0063012 / 




^H 






F3 •** 


PROG NOT ACTIVE •♦* 






/ 




H 






F2 PSH= 


=0740000000089858 






y 




^1 






REG 


9-0 OOO89E80 0009E447 


400B9F5A 4008AD9A 


00O892E0 80089EF0 00089AAO 


00089A7C J^ 




^^1 






REG 


1-8 00089024 00089AC0 


00089ECF 00089E80 


00000005 A0089EDC 0008A157 


00089978 




^1 






Fl **♦ 


PROG NOT ACTIVE «*» 










H 










♦ •• tONIHWICATJOII REGIW •»• 






^H 






HtX 


BG F4 


F3 


F2 Fl 






1 






DISP 


04AO 4850 


47A8 


4700 4658 


CCMMUpNICATION region AODKtSS 




^^B 






00 


10/04/74 lC/04/74 


1C/C4/74 


10/04/74 10/04/74 


CATE 




^^1 






08 


7C00 7CCC 


7CCC 


7000 7000 


PPBte ACER 




^^B 






OA 


7000 7CCC 


70CC 


7000 7000 


END OF STORAGE PROTECT 




^^1 






OC 


0000 ococ 


COCC 


0000 0000 


SEEK ADDRESS BLOCKtaNLY BG VLD 




HH 






OE 


0000000000 ocoocooccc cooccooooo 


0000000000 0000000000 


PROBLEM PROGRAM USERS 




^^B 








ooocoocc ococeccc 


CCCCCCCC 


OOOOOOOO OOOOOOOO 


AREA IN HEX 




j^O 






17 


00 cc 


CC 


00 00 


UPSl BYTE IN FfX 




[^H 






18 


CU1PCEN F4T 


NU NAt<F 


lfc5TF2 FISTCP 


JCB NAME 




^H 






20 


00060FFF O0O74FFF 


CCCCCCCC 


OOOAIFFF OOOBFFFF 


UPPERMOST BYTE OF EACH PPA 




^^B 






a^i 


00U43977 00064917 


CCCCCOCC 


0008C977 0OOA5977 


END 4CDR UF LAST FETCH JR LOAD 




^^1 






28 


OOOOOOOO CCOOOCOO 


COCCCCCO 


OOOOOOOO OOOOOOOO 


LARGEST PROBLEM PROGRAM PHASE 




^^B 






2C 


OOOC OCOC 


CCOC 


0000 0000 


LENOTF OF PP LABEL AREA 




^H 






2E 


0020 CC2C 


C03C 


0040 0060 


PROGRAM IDENTIFICATION Kt Y 




^^1 






30 


0013FFFF 0013FFFF 


C013FFFF 


0013FFFF 0013FFFF 


END i)F STORAGE ADDRESS 




^^1 






3* 


FL FD 


FD 


FO FC 


MACHINE CONFIGURATION 




^^1 






25 


7F 7F 


7F. 


7F 71= 


SYSTEM CONFIGURATION 




^H 






36 


FED30000FECO FEnSOCCCFEDC FED30000FE50 


FE030000FEOO FEC30000FECO 


JCB CONTROL SWITCHES 




^^B 






3C 


00C5 00C5 


C0C5 


00C5 00C5 


CISK ACOR OF LABEL CYLINDtP 




^^H 






3t 


4305 43C5 


43C5 


4305 4305 


ACER OF FOCL 




^H 






40 


430C 43CC 


430C 


430C 430 C 


ACCR OF PUB 




^^B 






42 


449E 44SE 


449E 


449E 449E 


ACCR OF FAVP 




^^1 






"i'* 


449F 449F 


449F 


449F 449F 


AOCR OF Jib 




^^1 






<\t, 


4e3l 4631 


4631 


4631 4631 


ACCR OF TFB 




^^1 






'ib 


40F8 4CFe 


40Fe 


40F8 40F6 


ACCR OF FICL 




^^1 






AA 


4CFE 4CFt 


40Ft 


40FE 40FE 


ACCR OF NICL 




^^1 






<.C 


4104 41C4 


41C4 


4104 4104 


Ar;CR OF LOB 




I^H 






4E 


38 36 


38 


38 38 


LINE COUNT FOR SYSLST 




^^1 






-iF 


I00474i77 1C04T4277 


1C0474<;77 


100474277 100474^77 


SYSTEM UATE 




^^1 






56 


0000 OCOC 


COCC 


0000 0000 


LIOCS COM BYTE 




^^1 






5A 


3CCC 3CCt 


3IXC 


30CC 3CCC 


ar.OK UF PIB TABLE 




^^1 






5C 


0000 OCOC 


COOO 


0000 0000 


L4ST CFECK POINT NO. 




|H 






5E 


003C CC3C 


CC3C 


003C 003 C 


JCM /ONE IN MINUTES 




^^B 






60 


48Fa 497C 


49Ee 


4A60 4«Ca 


ACCR OF DIB 




^^H 






62 


0000 CCCC 


ooco 


0000 0003 


CURRENTLY NOT ASSIGNED 




^^1 






6-* 


3fcC4 3EC4 


3EC4 


3EC4 3FC4 


&CDR OF PC OPTION TABLE 




^^1 






66 


3F44 3F44 


3F44 


3F44 3F44 


ACCR OF IT OPTION TABLE 




^^B 






68 


3FE4 3FB4 


3FB4 


3FB4 3Fe4 


ACCR OF OC OPTION TABLE 




^^B 






6A 


0010 CC2C 


C030 


0040 0050 


KEY UF PROGRAM WITH IT SUPPORT 




^^1 






6C 


0000 CCOC 


OOCO 


0000 0000 


CURRENTLY NOT ASSIGNED 




^^1 






6fc 


0000 0C2C 


C03C 


0040 0050 


LTK 




|H 






70 


00008C50 00008C47 


C0CCBC3E 


00008C35 00008C2C 


SYSPARM 




^^1 






74 


00007Cf)C 0C0C703e 


C0CC7DFC 


00007E«6 OOC07F60 


JOB ACCOUNTING 




I^H 






78 


00003O7C CC003e7C 


C0CC387C 


0000387C 0000387C 


ACCR OF TOO COMMUNICATIONS AREA 




^^H 






7C 


3CCC 3CCC 


3CCC 


3CCC 3CCC 


ACDK OF PIB EXTENSION 




^^B 






7E 


6488 6488 


64B8 


6488 64B8 


ACCR OF M ICR OTF LABEL 




^^H 






80 


OOOOOOOO ocococcc 


CCCCCOOC 


OOOOOOOO OOOOOOOO 


ACLR OF OTAM VECTOR TAoLt 




^^1 






64 


04*0 04A0 


C4A0 


04A0 04A0 


ACCR OF BG COMREG 




^^1 






B6 


10 IC 


10 


10 10 


OPT IQN INDICATOR BYTE 




^^1 






87 


El El 


El 


El El 


SYSTEM CONFIG BYTE 




^^1 






88 


0000059C OCO0C5';C 


C000C590 


OOOOCgO 00000590 


ACCR OF CUMRFG EXTENSION 




^^B 






8C 


coco CCCC 


COCO 


coco coco 


ASSEMBLER FLAGS 




HH 






8E 


07 cc 


CO' 


00 00 


DISK CONFIGURAIION BYTE 




^^B 






8F 


404040404040 4C4C4C4C404C 404C40404040 


404040404040 404040404040 


PROCEDURE NAME 




^^H 






97 


00 00 


00 


00 00 


CATALOGUED PROCEDURE FLAGS 




H 




--e 


98 


4Q404C4C4040 «C404C^C<%C^C *04iC404C4C*C 


404040404040 404040404040 


STATEMENT IVWME 




^^B 






9F 


00 OC 


00 


00 00 


91 BYTES SYSIN INDICATOR 




^^H 






«0 


"OOOOOOOO ococeccc 


CCCCCOCC 


OOOOOOOO OOOOOOOO 


ACCR OF PART CONT BLOCK 




1^1 




--• 


A4 


00 00 


00 


00 00 


POWEK/VS FLAG BYTE 1 




^^1 






A5 


00 cc 


CO 


00 00 


PCWER/VS FLAG BYTE 2 




HH 




Mlli^a>B 


A6 


0000 0000 


0000 


0000 0000 


CURRENTLY NOT ASSIGNED 




^1 




■ 




■■■■■■ 


HHHI 








1 



V 
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o 

\.._>' 







■ 


■ 


■ 


■ 


■ 






BHHHHH 




■ 














•*• 


PHYSICAL UNIT BLOCK TABLE *•* 








I 




• TOS 


CHAN 


CHAN 


TEB 


DEV 


DEV 


CHAN JOB OEV SHIT EOF lOERR OPER DEV BURST SEVEN 


* PUB OHNER • 




^H 






AND 


QUE 


FT» 


TYP 


CODE 


SCHO CTL BUSY CHAB SYSROR QUEO INTV END DV ON TRACK 


•• SHIP •• 




^^1 






UNIT 


PTH 








FLCS FLGS LE SYSIPT RECOV REO POST MPX TAPE 


• EXTENSION • 




^M 




000 


0009 


04 


00 


oo 


00 


80 F8 * 




0000 




^M 




^ 001 


OOOC 


FF 


00 


11 


00 


00 FB 




0001 




^^M 




• 002 


0000 


FF 


00 


21 


00 


00 F8 




0001 




^^B 




003 


OOOE 


FF 


00 


42 


00 


00 F8 




0001 




^^1 




004 


OOIF 


FF 


00 


00 


00 


00 F8 




0000 




^^B 




• 005 


Otll 


FF 


00 


BO 


FO 


00 F8 




0000 




^^1 




006 


0130 


FF 


00 


62 


00 


02 FB 




OOOB 




^^1 




_ OOT 


0131 


FF 


00 


62 


01 


02 FB 




00 IF 




^^1 




• ooa 


0132 


FF 


00 


62 


02 


02 FB 




0000 




^^1 




009 


0133 


FF 


00 


62 


03 


02 FB 




0000 




^^1 




_ 00» 


0134 


FF 


00 


62 


04 


02 FB 




0000 




^^1 




• OOB 


0260 


FF 


00 


63 


05 


02 F8 




OOIF 




^^1 




OOC 


0261 


FF 


00 


63 


06 


02 F8 




0000 




^^1 




_ 000 


02 AO 


FF 


00 


50 


C3 


00 CO 




0000 




^^1 




• OOE 


02A1 


FF 


00 


50 


C3 


00 CO 




0002 




^^1 




OOF 


02A2 


FF 


00 


50 


C3 


00 CO 




0002 




^^1 




^ 010 


02A3 


FF 


00 


50 


C3 


00 CO 




0008 




^^1 




• Oil 


02A4 


FF 


00 


50 


C3 


00 CO 




0000 




^^1 




012 


03 BO 


FF 


00 


50 


C3 


02 CO 


* 


0002 




^^1 




A 013 


0381 


FF 


00 


50 


C3 


02 CO 


. * 


0001 




^^1 




• 014 


0382 


FF 


00 


50 


C3 


02 CO 


* 


0008 




HJIP 




015 


0383 


FF 


00 


50 


C3 


02 CO 


« 


0008 




^B 






















/^//^/g- 


H 






■ 


■ 


■ 








HHHHH 




1 
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*♦♦ COPIED AND TRANSLATED CCB *•♦ 



00E680 


ADDR.OF CCB COPY BLOCK QUEUE 


0000 


RESIDUAL COUNT 


00 


1ST COHMUNICATION BYTE 


00 


2ND COHMUNICATION BYTE 


0000 


STATUS BYTES FROM CSM 


20 


LUB CLASS 


04 


LUB NUMBER 


000OE830 


ADDR.OF CCW STRING 


00 


3RD COMMUNICATION BYTE 


061S18 


CCW ADDRESS IN CSH 


0000000000000000 


USER SENSE CCW 


0020 


PIK VALUE 


CO 


FLAG BYTE 


00 


UNUSED 


000614Ee 


ADDR.OF VIRTUAL CCB 


0OO0E83O 


ADDR.OF CCW COPY. BLOCK 


00000000 


ADDR.OF I DAL 


000000000000004000000000000000000000000000000COO 


PAGES FIXED 


00000000 •■*— ^ 


PTR TO FIXINF EXT 


00O0E9O8 ^v 


ADDR.OF NEXT CCB 



^e F/y/f^r £xr /3^ocK5 C T/Um. 



' /■f^tiefi/' J 



(Cx /ftKr) 



*•* COPIED AND TRANSLATED CHANNEL PROGRAM •** 



ADDR.OF CCM BLOCK 



o 





CON. CODE 


DATA A DDR 


CCWl 


09 


01C96E 


CCW2 


01 


01C8EE 


CCH3 


09 


Q1C9BE 


CCH4 


00 


000000 


CCH5 


00 


000000 


CCN6 


00 


000000 


CCM7 


00 


000000 


TIC 


80 


000000 


TIC 


88 


000000 



FLAGS BYTE COUNT VIRT. ADDR.OF 1ST CCM ADDR.OF NEXT CCM BLOCK 

60 OOOF 061500 000000 

50 0003 

20 OOIC 

00 0000 

00 0000 

00 0000 

00 0000 



(exm^A 



»** IDAL BLOCK QUEUE •♦» 
NO lOAL BLOCK QUEUE AVAILABLE 

•** FIXED PAGE FRAMES *»* 



(Sxnokm 
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»♦* COPIED AND TRANSLATED CCB *** 



00E908 


AOOR.OF CCB COPY BLOCK QUEUE 


OOOO 


RESIDUAL COUNT 


04 


1ST COMMUNICATION BYTE 


00 


2ND COMMUNICATION BYTE 


0000 


STATUS BYTES FROM CSH 


20 


LUB CLASS 


04 


LUB NUMBER 


OOOOETES 


AODR.OF CCM STRING 


00 


3RD COMMUNICATION BYTE 


041T80 


CCM ADDRESS IN CSW 


0000000000000000 


USER SENSE CCH 


0010 


PIK VALUE 


CO 


FLAG BYTE 


00 


UNUSED 


00041T12 


AODR.OF VIRTUAL CCB 


0000E7E8 


AODR.OF CCW COPY. BLOCK 


0O0OE950 


AODR.OF lOAL 


000000000001800000000000000000000000000000000000 


PAGES FIXED 


00000000 


PTR TO FIXINF EXT 


00000000 


AODR.OF NEXT CCB 



^ex/t/ Hr) 



ADM.OF CCW BLOCK 



•«* COPIED AND TRANSLATED CHANNEL PROCRAN ••* 





CON. CODE 


DATA AODR. 


FLAGS 


BYTE COUNT 


CCUl 


09 


0ITF88 


60 


OOIC 


CCU2 


09 


017FA4 


60 


0020 


CCM3 


09 


017FC4 


60 


002F 


CCH4 


09 


00E950 


64 


OOIF 


CCNS 


09 


018012 


60 


0021 


CCW6 


09 


018033 


60 


0021 


CCM7 


09 


018054 


60 


0020 


TIC 


88 


00E710 






TIC 


88 


000000 






CCMl 


09 


018074 


60 


0020 


CCM2 


09 


018094 


20 


0025 


CCW3 


00 


000000 


00 


0000 


CCH4 


00 


000000 


00 


0000 


ecus 


00 


000000 


00 


0000 


CCM6 


00 


000000 


00 


0000 


CCU7 


00 


000000 


00 


0000 


TIC 


80 


000000 






TIC 


88 


000000 







VIRT. AODR.OF 1ST CCH AODR.OF NEXT CCH BLOCK 



V ..,/' 



*»* IDAL BLOCK QUEUE »** 
AODR.OF IDAL BLOCK lOAL ADDRESSES 

00E950 00017FF3 00018000 FFOOOOOO 



*♦* FIXED PAGE FRAMES »** 



0000047 0000048 
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033000 




oo 


NOT 


ADDRESSABLE 










033800 




oo 


NOT 


ADDRESSABLE 










034000 




00 


NOT 


ADDRESSABLE 










034800 




00 


NOT 


ADDRESSABLE 










035000 




00 


NOT 


ADDRESSABLE 










035800 




oo 


NOT 


ADDRESSABLE 






/ 




036000 




OQ 


NOT 


ADDRESSABLE 






SefWiyftA 3 


smA 


036800 




oo 


NOT 


ADDRESSABLE 1/ 


-' /IL 






037000 




00 


NOT 


ADDRESSABLE 






/ 


A 




037800 




00 


NOT 


ADDRESSABLE 










038000 




00 


NOT 


ADDRESSABLE 












038800 




oo 


NOT 


ADDRESSABLE 












039000 




00 


NOT 


ADDRESSABLE 












039800 




00 


NOT 


ADDRESSABLE 












03A000 




oo 


NOT 


ADDRESSABLE 












03A800 




00 


NOT 


ADDRESSABLE 












038000 




00 


NOT 


ADDRESSABLE 












038800 




00 


NOT 


ADDRESSABLE 












03C000 




00 


NOT 


ADDRESSABLE 












03C800 




00 


NOT 


ADDRESSABLE 












03D000 




00 


NOT 


ADDRESSABLE 












03D800 


030800 


00 


CHANGED N 












03EOOO 
03E800 


03EOOO 
03 E 800 


00 
00 


CHANGED I LaU /l<pf4' of 
CHANGED ( / /- 
CHANGED ; ft^ A4<mt.^ 










03F000 
03F800 


03FOOO 
03F800 


00 
00 






































r 








ZAw ^ca 




new Bi'cK 




/Jo 




0^L /UMa.^ k^K. Obitt/ 






/fooo 


J.K.. 


^-^ 


c 


1 




h<xa(L -^TStffta- /S^^C efiec^i 




\ -. ro/oj 




*f_ 




yC 


\b9^ 


Jt'too' 


5o 




i^Uyu ^ ..^M^ i^ a 


Mi 


/for i/i£^ 
Zoooo 


i/ 


^ 


"^^''"'' " '/3/ 


1 




/mJ*^ t^ /ta^ a^ 






it 
S3 


J 


"^ 


WOOO / ii 


^ J 




-^^Oarc^, a.^^rc<z..'^c<yr*l . 




\ 


ioiicT "' 


f 


r 


■5 c 


V pf v' 


/f«00 










*** SEGMENT TABLE »*• 




*** p 


AGE TABLE 


♦** 






1 


• ADOR.OF 
O0E65C 


ST PT ENTRIES PT ORIGIN ADDR 
32 00E430 




t^IRT.AOOR 
040000 


REAL ADDR 
020800 


KEY 

10 


STATUS 
CHANGED 




) 


^ 










040800 


019800 


10 


CHANGED 












041000 


017800 


10 


CHANGED 












041800 


018000 


10 


CHANGED 












042000 


018800 


10 


CHANGED 












042800 




10 


NOT 


USED 












043000 




10 


NOT 


USED 












043800 




10 


NOT 


USED 












044000 




10 


NOT 


USED 






Se^/rrU.n/C' /" 






044800 
045000 
045800 
046000 




10 
10 
10 
10 


NOT 
NOT 
NOT 
NOT 


USED 
USED 
USED 
USED 








B^V 


046800 




10 


NOT 


USED 








047000 




10 


NOT 


USED 










047800 




10 


NOT 


USED 










048000 




10 


NOT 


USED 












048800 




10 


NOT 


USED 












049000 




10 


NOT 


USED 












049800 




10 


NOT 


USED 












04AOOO 




10 


NOT 


USED 












04A800 




10 


NOT 


USED 












048000 




10 


NOT 


USED 












04B800 




10 


NOT 


USED 












04C000 




10 


NOT 


USED 












04C800 




10 


NOT 


USED 












04D000 




10 


NOT 


USED 












04D800 




10 


NOT 


USED 












04E000 




10 


NOT 


USED 












04E800 




10 


NOT 


USED 












04FOO0 




10 


NOT 


USED 










1 


04F800 




10 


NOT 


USED 










C£y/t^/t:^ 
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■1 




■BMMHHMHM| 




|MMMMMHMH| 




■«»» 


SEOMENT TABLE ••* 




*•« 


PAGE TABLE •♦♦ 




V /^e 




STATUS / 
CHANGED 


• ADDR.OF ST 
O0E668 


PT ENTRIES PT ORIGIN ADOR 
32 00E5B0 




VIRT.ADDR 
OAOOOO 


REAL AOOR KEY / 
028800 AO^ 1 






"""f"' 






^-2 1/ 


0A0800 


028000 40 (y 


CHANGED 










OAIOOO 


02ABOO 40 f 


UNCHANGED 














0A1800 


02B000 40 1 
50 


UNCHANGED 
NOT USED 






■ 1 


i 


0A2000 










0A28O0 


50 


NOT USED 














OA3000 


50 


NOT USED 














0A38O0 


50 


NOT USED 














OA4000 


50 


NOT USED 














0A4800 


50 


NOT USED 














OASOOO 


50 


NOT USED 














0A5800 


50 


NOT USED 














0A5000 


50 


NOT USED 








^<e«*t««/^^ 






OA6800 


50 


NOT USED 












0A7000 


50 


NOT USED 








T^ 






0A78O0 


SO 


NOT USED 














OASOOO 


50 


NOT USED 














0A8800 


50 


NOT USED 














0A9000 


50 


NOT USED 














OA9800 


50 


NOT USED 














OAAOOO 


50 


NOT USED 














OAieoo 


50 


NOT USED 














OABOOO 


50 


NOT USED 














0AB800 


50 


NOT USED 














OACOOO 


50 


NOT USED 














0AC8OO 


50 


NOT USED 














OAOOOO 


50 


NOT USED 














0AO800 


50 


NOT USED 














OAEOOO 


50 


NOT USED 














0AE800 


50 


NOT USED 














OAFOOO 


50 


NOT USED 














0AF800 


50 

/ 


NOT USED 










A^ 


'1/ 












*•* 


SEGMENT TABLE «** 






*** 


PAGE TABLE •*• 








• ADDR.OF ST 


PT ENTRIES PT ORIGIN ADDR 






VIRT.ADDR 


REAL AOOR KEY 


STATUS 






0OE66C 


32 00E5F0 
/ 






OBOOOO 
OB0800 
OBIOOO 
0B1800 
OBZOOO 
0B2800 
OB3000 
0B380O 
0B4000 
0B4800 
OB5000 
0B5800 


50 
50 
50 
50 
50 
50 
50 
50 
50 
50 
SO 
SO 


NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 
NOT USED 












0B6000 


50 


NOT USED 












OB6800 


50 


NOT USED 














OB7000 


50 


NOT USED 














OB7800 


SO 


NOT USED 














0B8000 


SO 


NOT USED 














0B8800 


SO 


NOT USED 














0B9000 


SO 


NOT USED 














0B9800 


SO 


NOT USED 














OBAOOO 


50 


NOT USED 














0BA800 


50 


NOT USED 














OBBOOO 


50 


NOT USED 














0BB800 


SO 


NOT USED 














OBCOOO 


SO 


NOT USED 














0BC800 


SO 


NOT USED 










7 




OBDOOO 


50 


NOT USED 












OBDSOO 


50 


NOT USED 














OBEOOO 


50 


NOT USED 






- • 








0BE800 


SO 


NOT USED 














OBFOOO 


50 


NOT USED 










.,„_ 


' 


OBF800 


50 


NOT USED 


..(yfi'Mr 






HHI 




BHHBB 









V .r' 
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IHI 




■ 






mi 






■ 


1 






















I 


H 










«•• PAGE FRAPE 


TABLE •«• 




*« 


PFT exT ♦♦ 


H 


^M 








FU6S 












^1 


^^M 




♦ ttfi.Cf PFT 


FIX CNT 


NFF W J( 


> hf 


FCR»AR0-P1I» 


eAtKtiAf)0-FTR 


FACE NP 


ACCR.OF PA6E 


PFIX CNT 


^H 


^^M 




OOfEtO 


09000 











0000 


090000 


000 


^H 


^^M 


QQfttt 


CCCCC 




L C 






0001 


oooeoo 


CCC 


^H' 


^^M 




OOFETO 


OOOOC 




I c 






Q002 


001000 


000 


^H 


^^M 




COftlB 


COCCC 




I c 






0003 


001800 


OOC 


^H 


^^M 


OQFEaO 


OOOCC 




I c 






0004 


002000 


000 


^H 


^^M 




ooFeee 


3CC0C 




L C 






0005 


002800 


000 


^H 


^^M 




00FE9O 


OOCCC 




I c 






0006 


003000 


000 


^H 


^^M 


ooFtse 


COCCC 




L C 






0007 


003800 


CCC 


^H 


^^M 




OOFE«0 


00000 




c 






0008 


00*000 


000 


^^1 


^^M 




OOFt/lS 


COCCC 




L C 






0009 


00*800 


000 


^^1 


^^M 


OOFEEO 


OOOOC 




C 






0010 


005000 


000 


^H 


^^M 




COFEEa 


COCCC 




L C 






0011 


005900 


000 


^H 


^^M 




OOFECO 


OOOOC 




L C 






0012 


006000 


000 


^H 


^^M 


coFfcte 


CCOOC 




1 c 






0013 


006800 


coo 


^H 


^^M 




OOFECO 


OOOCC 




c 






001* 


007000 


000 


^H 


^^M 




ooFtce 


OCCOO 




c 






0015 


007800 


COO 


^H 


^^M 


OOFEEO 


OOOCC 




c 






0016 


008000 


000 


^H 


^^M 




OOFtEe 


CCCCC 




c 






0017 


008800 


000 


^H 


^^M 




OOFEFO 


OOOOC 











0018 


009000 


000 


^H 


^^M 


OOFEFB 


COCCC 




c 






0019 


009800 


coc 


^H 


^^M 




OOFFOO 


COCCC 











0020 


OOAOOO 


000 


^H 


^^M 




COFFOe 


COCCC 











0021 


00A8OO 


coo 


^H 


^^M 


OOFFIO 


OOOCC 




c 






0022 


008000 


000 


^H 


^^M 




COFFie 


CCCCC 




c 






0023 


008800 


000 


^H 


^^M 




O0FF2O 


COOOO 




c 






002* 


OOCOOO 


000 


^H 


^^M 


COFFZe 


COCCC 




c 






0025 


ooceoo 


000 


^^1 


^^M 




OOFF30 


OOCCC 




c 






0026 


COOOOO 


000 


^^H 


^^M 




00FF28 


COCCC 











0027 


000800 


000 


^^B 


^^M 


OOFF*0 


OOCCC 




c 






0026 


OOEOOO 


OOC 


^^|: 


^^M 




OOFF*a 


CCCCC 




L C 






0029 


0OE8OO 


occ 


^^B 


^^M 




OOFF50 


OOOCC 




I c 






0030 


001=000 


000 


^^1 


^^M 


OOFFiB 


OOCCC 




c 






0031 


OOF800 


OOC 


^^1 


^^M 




OOFFeO 


OOCCC 




c 






0032 


010000 


000 


^^1 


^^M 




COFFtt 


CCCCC 




I c 






0033 


010800 


coc 


^^B 


^^M 


O0FF7O 


00000 




c 






003* 


OllOOO 


000 


^^B 


^^M 




C0FF7B 


COCCC 




c 






0035 


011800 


000 '«^ Ti,*^^^ *^ 


^Hj 


^^M 




00FF80 


OOOCC 











0036 


ouooo 


^^1 


^^^1 


coFFee 


COCCC 




I c 






0037 


012800 


000 oJm*^ ffoo '-*'«^ 


^^^1 


^H 




00FF90 


OOOOC 











0038 


013000 


^H 


^^1 


-^ 


00FF9e 


CCCCC 




c 






0039 


013800 


OOC , £ , . 


^^H 


^^1 


OOFF/IO 


OOOCC 




c 






00*0 


01*000 


000 ^.^.W. Jry i>^ 
000 i%S\.rtuX JJi e^ 


^^1 


^^1 




00FFI8 


30000 




L C 






00*1 


01*800 


^^1 


^H 




OOFFEO 


00000 




c 






00*2 


015000 


^H 


^^1 


OOFFCa 


COCCC 




I C 






00*3 


015800 


coo r—^— .T—- » v^ 


^^H 


H 




OOFFCO 

eoFfca, 


00000 
OOOCC 





L C 






00** 


016000 
Ol6ftfl0 


°°« '^ri^tc*^ tU^J^U^ 


H 


^^1 


Cn'OFFCaJ 


OOOCO 




3 C 


OlCOTC 


010028 


(0*0003? 


IZ */ J^oooo 


^^1 


^^1 




^-tsmte 


OOCOO 




: c 


0102 76 


OOFFEO 


0129 


0*08<5o 


^^1 


^^1 




OOFFEO 


OOOCO 




; c 


OOFFOe 


010030 


0130 


0*1000 


000 ^ 


^^1 


^^1 


O0FFE8 


CCCCC 




c 


ClOOJO 


OOFFFO 


0131 


0*1800 


000 


^^1 


^^1 




OOFFFO 


OOOOC 




) 


OOFFEB 


OITJOOO 


0132 


0*2000 


000 


^^1 


^^1 




OOFFFe 


OOOCC 




' c 


01CC18 


010270 


038* 


ocoooo 


000 


^^1 


^^1 


C 10000 


00000 




: c 


OOFFFO 


oioooe 


0133 


0*2800 


000 


^^1 


^^1 




010008 


0O(ICC 




: c 


OICOOO 


010010 


013* 


0*3000 


000 


^^H 


^^1 




010010 


OOOOC 


C C 


3 C 


01 coca 


010040 


0139 


0*9800 


000 


^^P 


1 


oiooia 


COOOC 


C C ( 


: c 


01 0020 


OOFFFB 


0136 


0**000 


000 


1 


1 






■■ 




■ 






Bl 






1 
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/\ppciidiX6s 



Appendix G 



EXAMPLE OF A 
STANDALONE 
DUMP OUTPUT 



\ / 




\..= 



.^if' 



Figure G.l An example of a formatted stand-alone dump output, part 20 of 20 



A.30 Appendixes 



m I 






Appendix H 

Job Accounting Interface TABLES USED BY 

JOB ACCOUNTING 
The Job Accounting Interface provides job step and job information that you can 
use for charging system use, supervising system operation, plaiming new applications. 

The job accounting option is supported when JA=YES in the FOPT supervisor 
generation macro. When this option is supported, the following tables are generated: 

• Ajob accounting interface partition table for each partition 

• Ajob accounting common table. 

Both tables are generated as part of the supervisor. 

The interface table is part of the partition table and provides user access to the job 
accounting routines and information. 

For each job step the following information is accumulated in this table: 

Job name 

User information 

Partition ID 

Cancel code 

Record type 

Date 

Job start time 

Phasename (from EXEC card) 

Highest address used (from communications region) 

CPU time 

Overhead time 

Stop time (at EOJ only) 

All bound time 

SIO count (optional). 

Note: // the CPU is not equipped with a timer, time fields are zero. 

To utilize this information, you must link-edit a routine to be relocatable by using the 
relocating loader option (or write a self-relocating routine) to store or print the desired 
portions of the table. This routine must be cataloged in the core image library under 
the name SJOBACCT. 

How to locate 

The address of the interface partition table is contained in bytes X'74' — X'77' of the 
partition communication region. 

The address of the common table is contained in bytes X*7C' - X7F' of SYSCOM. 
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r 



This part of the 
table is for -^ 

user reference 



V 



Displacement 


Label 


Description 




(ACGTABLE) 




-3 


ACCTWK1 


Work area used in SIO update 


4 -7 


ACCTWK2 


Work area used with ACCTWK1 in start/stop time routine 


8 -11 


ACCTSVPT 


Job card pointer; address of job card field following jobname 


12 


ACCTPART 


ID of partition in charge (partition switch name) 


13 


ACCTRES2 


Reserved 


14-15 


ACCTLEN 


Length of SIO area = 6n-i-1 , where n = number of devices for this 
partition in SYSGEN option JA = n1, n2, n3, etc.) 


16-21 


ACCTLOAD 


Label area instruction; moves JAI label area address to OPEN/CLOSE 
transients 


22-23 


ACCTRES3 


Reserved 


24-27 


ACCTLADD 


Address of alternate label area 


28-31 


ACCTPUT 


Counter for CPU time elapsed in a jobstep, counted in 300ths 
of a second 


32-35 


ACCTOVHT 


Counter for overhead time: time not charged to any partition 


36-39 


ACCTBNDT 


Counter for all-bound time: system wait state time divided between 
running partitions 


40-47 


ACCTSVJN 


Save area for job name during simulated EOJ 


48-55 


ACCTJBNM 


Job name; taken from job card 


56-71 


ACCTUSRS 


User information 1 6 bytes from job card 


72-73 


ACCTPTID 


Partition ID: 'BG', 'FV, 'F2', etc. in EBCDIC format 


74 


ACCTCNCL 


Cancel code; see Cancel Codes and Messages 


75 


ACCTYPER 


Type of record: 'S' = job step, 'L' = last step of job 


76-83 


ACCTDATE 


Date in format specified at SYSGEN (MM/DD/YY or DD/MM/YY) 


84-87 


ACCTSTRT 


Start time of job step, in packed decimal (DHHMMSSF; F = sign) 


88-91 


ACCTSTOP 


Stop time of job step, in same format as ACCTSTRT 


92-95 


ACCTRES 


Reserved 


96-103 


ACCTEXEC 


Phase name taken from execute card 


104-107 


ACCTHICR 


Real mode: high storage address of partition. If SIZE= was specified 
in the EXEC statement, this field contains the specified value. 
Virtual mode: simulated high storage address. The number of pages 
referenced in the partition is multiplied by 2K and the result is added 
to the start address of the virtual partition. 


108-111 


ACCTIMES 


CPU time elapsed in a job step counted in 300th of a second 


112-115 




Overhead time: elapsed time not charged to any partition, in 300ths 
of a second 


116-119 




All-bound time: system wait state time divided between running 
partitions, in SOOths of a sec. 


120 


ACCTSIOS 


SIO tables: 6 bytes for each device specified by SYSGEN options, 
as follows: 2 bytes for device address (Ocuu), 4 bytes for count of 
SIOs in current jobstep. 

Overflow byte: normally X'20', but is X'30' if more devices are used 
within a partition than specified by SYSGEN options 







Notes: DSECT ACCTABLE symbolically addresses the JAI Partition Tables with labels as shown. Each 

partition in which JAI is supported has its own JAI Partition Table. This table is labeled ACCTBG 
for the active partition BG, ACCTF1 for the active partition F1, ACCTF2 for the active partition, 
F2, etc. 

Figure H-1 Explanation of the contents of the Job Accounting Interface partition table. 
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Displacement 


Label 


Description 




(ACCTCOMN) 




0-15 


ACCTSVRG 


Temporary register save area 


16-17 


ACCTSVRX 


Save area for remainder of overhead counter times 
distributed by partition on exit 


18-19 


ACCTSVRE 


Save area for remainder of all-bound counter times 
distributed by partitions on entry 


20-23 


ACCTPCNT 


Count of partitions using the Job Accounting interface 


24 


ACCTSAID 


Owner of physical transient area *) 


25 


ACCTFAID 


Interrupted program *) 


26 


ACCTRAID 


Active program *) 


27 


ACCTSWCH 


Accounting switches: if bit = 1 , true; if bit = 0, not true 
bit 0: cancel accounting bit 4: IPL indicator 
bit 1: no active partitions bit 5: not used 
bit 2: catalog in process bit 6: not used 
bit 3: alternate label area bit 7: not used 


28-31 


ACCTIME 


Start time of current accounting interval, in complement 
format 


32-33 


ACCTRESC 


Reserved 


34-35 


ACCTUSEP 


Address of user save area (ACCTUSER) 


36-37 


ACCTUSEL 


Length of user save area (Set with 1st operand of FOPT 
macro parameter JALIOCS) 


38-39 


ACCTSJOB 


Job accounting partition indication 


40-43 


ACCTBLES 


Address of BG Job Accounting Table 



TABLES USED BY 
JOB ACCOUNTING 



If multiprogramming is supported, this table is to be extended with one of the 
following fields (depending on the number of supported partitions), otherwise the 
table ends here. 



44-47 Address of F1 Job Accounting Table 

48-51 ACCTSEAS Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



44-47 
48-51 
52-57 



44-47 
48-51 
52-55 
56-63 



44-47 
48-51 
52-55 
56-59 
60-69 



ACCTSEAS 



Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



ACCTSEAS 



Address of F4 Job Accounting Table 

Address of F3 Job Accounting Table 

Address of F2 Job Accounting Table 

Address of F1 Job Accounting Table 

Control Field: prevents the accounting routine being 

active in more than one partition simultaneously 



*) These values are the same as the PIK values for the relevant tasks 

Figure H-2 Explanation of the contents of the Job Accounting common table. 



NPARTS= 2 



InPARTS= 3 
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yNPARTS = 5 
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TABLES USED BY 
JOB ACCOUNTING 



Programming considerations 

The user program for processing the information entered by the supervisor in the 
Job Accounting Table must be cataloged and be self relocating with the name 
JtJOBACCT in a core image library. For efficiency, an overlay structure should be 
avoided, and the length of the program should preferably not exceed one core 
image library block. 

Because $JOBACCT is called in at the end of each job step, it should perform only 
data gathering and recording, but not data reduction and formatting if additional 
system overhead is to be held to a minimum. Overhead depends largely upon the 
efficiency of SJOBACCT. The optional SIO accounting (.JA=nl , n2, n3) also 
causes additional overhead. 

LIOCS uses registers 13-15. If SJOBACCT needs any of these registers after a 
LIOCS function has been performed, save and restore the desired registers 
(register 14 should always be saved when using LIOCS because it is necessary to 
return to job control via the instruction BR 14). Chapter 9 in this section describes 
the usage of the general registers by system control programming and job accounting. 

If SJOBACCT uses LIOCS, it should save at least part of the DTF Information 
(status switches, extent information, and pointers) in the user save area. If more 
than one DTF is used, information from each should be saved. The user save area 
may be used to save any type of information as well as to accumulate step to 
step statistics for end job accounting. This accumulation reduces the rate of 
scheduled output records caused by writing a step accounting record for each job 
step. The user save area is not accessed by system functions. Chapter 12 in this 
section describes the save areas and the system generation macro JALIOCS. 

If an error causes $JOBACCT to be canceled, "JOB ACCT" appears in the 
cancel message, and the problem program name appears in the EOJ message. 
The STXIT option may be used to pass a message informing the operator that 
an error occurred in I^JOBACCT rather than in the problem program. (A descrip- 
tion of tables used by user exit routines can be found in Section 4 of this 
manual, Chapter 10). The job in that partition is terminated and normal pro- 
cessing continues with the next job. 

Refer to DOS/VS System Management Guide for details on writing job accounting 
routines. 
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Appendix J 

PROCESSING TAPE ERROR 
STATISTICS USING EREP 



You can cause detailed or summarized tape statistics to be printed through the use 
of the various combinations of EREP options shown in Figure F-3-D in Section 2-F 
of this manual. The summarized format combines the individual recordings (for 
example. Unit Check, Volume Dismount, and End-of-Day records) either by volume 
serial number or by tape unit, and prints the summarized statistics. The detail format 
prints each recording in either volume serial number format or tape unit format. 
Whenever detail or summarized data is printed in volume serial number format, the 
data is printed in sequence by volume serial number. 

Example 1 : Print detail tape error statistics from SYSREC. The information is 
printed in the format of record 4 of the example printout below. Enter the following 
job control statements: 

// EXEC EREP 
OPTION TES,NOTAPEJPRINT 

/* 

Example 2: Print the summarized tape error statistics from SYSREC only. The data 
is printed in the format of record 3 of the example printout below. Enter the 
following job control statements: 

// EXEC EREP 
OPTION TES,NOTAPE,SUM 

/* 

Example 3: Print the detail tape error records and then print their summary by 
volume serial number. The data is printed in the format of records 1 and 3 of the 
example printout below. The following job control statements: 

//EXEC EREP 
OPTION TES,NOTAPEJ>RINT,SUM,SUMTAPE,VOL 

/* 

The work tape will contain a sequential list of all volume serial numbers along with 
a 5-byte disk address for each of these numbers. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. After the scratch tape is mounted the operator should 
press END or ENTER. If the operator chooses not to mount a work tape, he 
should type CANCEL and press END or ENTER. This causes the SUM and 
PRINT TES options to be canceled. Any other response results in the messages 

3E25I INVALID RESPONSE 

3E08A MOUNT SCRATCH TAPE ON SYS008 

being printed on SYSLOG. 
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PROCESSING TAPE ERROR 
STATISTICS USING EREP 



Example 4: Update the TES history tape on SYS007. Then a scratch tape is 
mounted on SYS008. The error records are edited and printed from SYSRES onto 
SYSLST in the detail volume serial number format (record 2 of the example print- 
out below). The tape error records on the history tape are then summarized and 
printed on SYSLST in the summarized volume serial number format (record 1 of 
the example printout below). Enter the following job control statements: 

// LBLTYP TAPE 
// TLBL EREPNEW 
// EXEC EREP 

OPTION HIST 

OPTION TES,PRINT,SUM,SUMTAPE,VOL 

/* 

First the TES history tape is updated: the message 

3E09A MOUNT TES HISTORY TAPE ON SYS007 

is printed on SYSLOG. After the TES history tape has been updated, the tape error 
data on SYSREC is edited. The message 

3E08A MOUNT SCRATCH TAPE ON SYS008 

is printed on SYSLOG. The tape data is printed on SYSLOG and then the message 

3E18A MOUNT HISTORY/RDE TAPE 

is printed on SYSLOG. The history tape is read and the tape error data is sum- 
marized by volume serial number. Finally, the history tape is updated and the 
SYSREC file is cleared. 



\.,.../' 
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An example of the EREP TES print formats. 
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Note: This option of 
EREP is not applic- 
able to Models 115, 
125, and 155. 



Appendix K 

EXAMPLES OF THE 
SUM OPTION OF EREP 



Example 1 : The job control statements required for a summary of the SYSREC file 
by disk, tape, unit record, and TP groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=DISK,TAPE,UNITREC,TP 

/* 

Example 2: The control statements required for a summary of the SYSREC file 
by MICR/OCR, CPU, and 2715 hardware groups are: 

// EXEC EREP 
OPTION SUM 
GROUP=MICR/OCR,CPU,27 15 

/* 

The 2715 groups is summarized first 






Example 3: job entered through SYSIPT requesting the RDE Summary Option 

// JOB EXAMPLE 

// ASSGN SYS009,X'283' 

// TLBL EREPNEW 

// LBLTYP TAPE 

// EXEC EREP 

OPTION SELECT,TAPE 

DEVICE-2314 

CUA=0134 
OPTION RDESUM 

OPTION RDESUM 

OPTION EDIT 
/* 
/& 

The RDE summary parameters will be requested on SYSLOG. 
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Appendix L 



SERVICEABILITY AIDS 
FORPOWER/VS 



RJE, BSC I/O TRACE 

An I/O trace for an RJE, BSC line after SIGNON can be initiated by specifying 
YES to TRACE = in the PRMT macro. 

Entries are made in a wraparound buffer in the phase IPW$$TM, The following 
information is recorded at every I/O interrupt from this terminal. 



n 



k- 



X'OO' 



Up to 1 5 entries of 256 bytes 

each. The last entry is followed 

by a zero entry. 

Thus the last w,»/^. 

u X AO 

event may be 

easily identified. 



-32 bytes - 



Buffer Control Area (BCA) 
151 Bytes 



v// //Mwm> w// // //// ////// ^^ ^^ ^ 



First 16 bytes sent/received 



g 



Last 16 bytes sent/received) 



Line Control Block (LOB) 
beginning with 'LCBBUFAD' 
64 Bytes 



> Trace Entry 



Y 



For details of the BCA and LCB formats, see DOS/VS POWER/VS 
Logic, SY33-8576. 



The trace is to be used when RJE, BSC line errors occur or incorrect output 
is encountered which can be caused by the I/O operation, 

A dynamic, continuous trace of BSC RJE activity may be taken using the 
following steps. The user should be familiar with SDAIDS before referring 
to these steps. 

• Obtain a dump of the POWER/VS partition. 

• Locate the POWER/VS line manager in the dump C'LMCS VxMy"). 

• Within the line manager locate the constant "SDAID 'IF' >". 

• The instruction immediately following this constant is fetched when 
the trace area is full and wrap-around will occur. 

• Use SDAIDS instruction fetch at this location with OUTCLASS=PDUMP, 
X'AAAAAA', X'BBBBBB', where "AAAAAA" is the virtual address 

of the start of trace area (beginning on the second DOS/VS page from the 
above instruction), and "BBBBBB" equals "AAAAAA" + X' 1 0001 ' . 

This will provide a continuous trace of activity on any or all lines generated 
with TRACE=YES in the PRMT macro. 

Note: Trace activity begins with SIGNON. 
POWE R/VS FILE DUMP PROGRAM 

This program enables any of the POWER/VS files (account, queue, data) to be 
dumped on a line printer assigned to SYSLST. An option is also provided to 
enable queue records and their associated track groups belonging to specific 
jobs to be dumped. 
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line 2 

line 3 

line 4 



Appendix L 

SERVICEABILITY AIDS 
How to Execute FOR POWE R/VS 

The program is requested by JCL commands entered either via SYSLOG or 
SYSIN. Before requesting ensure relevant assignments are made for the file 
to be dumped. 

Example Job Stream 

1 1 JOB name 

//ASSGN (SYSOOO for Account file) 

(SYSOOl for Queue file) 

(SYS002-6 for Data files) 
//EXEC IPW$$DD 

When the program is loaded successfully, the following message will be issued 
to SYSLOG: 

DUMP FUNCTION = 

At this point one of the following options can be entered via SYSLOG: 

A (to specify the Account file) 

Q (to specify the Queue file) '^ 

D (to specify the Data file) 

Jobname (,jobnumber)(,queue)2 

EOJ (to enable cancelation of the program or selection of a new option) 

■' The complete data file will be dumped. 

2 This enables queue record(s) belonging to a specific job in the RDR, LST, 
or PUN queue plus its associated track group(s) to be dumped. Job name 
may be eight characters, job number may be six characters. For the 'queue' 
option one of the following three entries can be specified: 

L, for LST queue (default) 
P, for PUN queue 
R, for RDR queue. 

After the dump is completed, the message 

DUMP FUNCTION - 

is issued to SYSLOG again to enable either a new option to be specified or the 
program to be terminated by the option EOJ. 

Format of Output 

For every 100 bytes, a block of four lines is printed. Line 1 contains the 
printable characters in those bytes; line 2 contains the zone-part of each byte; 
line 3 contains the numeric part of each byte; line 4 contains a scale indicating 
the position of the bytes in the string. 

CHAR // JOB POWJOBOl DATE 08/19/74, 

ZON 664DDC4DDEDDCFF44444444444 4444CCEC4FF6FF6FF6 

NUMR 11016207661620100000000000 00004135008119174B 

01. . .5. . .10. . .15. . .20. . .25. .85. . .90. . .95 

AppcllCliXcS i^.oy 
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GLOSSARY 



This glossary contains technical terms associated with the subject of this publication. A more general range of terms 
is contained in IBM Data Processing Glossary, GC20 - 1699. 

IBM is grateful to the American National Standards Institute (ANSI) for permission to reprint its definitions from the 
American National Standard Vocabulary for Information Processing (copyright © 1970 by American National, Standards 
Institute, Incorporated) which was prepared by subcommitte X3K5 on Terminology and Glossary of American 
National Standards Committee X3. These definitions are indicated by an asterisk. 



o 



address translation. The process of changing the 
address of an item of data or an instruction from its 
virtual address to its real storage address. See also 
dynamic address translation. 

asynchronous, without regular time relationship. 

auxiliary storage. Data storage other than real 
storage; for example, storage on magnetic tape or 
disk. Synonymous with external storage, secondary 
storage. 



B 



basic control mode. When PSW bit 12 is 0, PSW 

format and system operation are compatible with 
standard System/360 operation. This is the basic 
control mode in which control registers 0, 8, and 
14 are available to the system. Abbreviated to BC 
mode. See also "Extended Control Mode'.' 

BTAM (basic telecommunications access method). 

A basid access method that permits a READ/WRITE 
communication with remote devices. 

buffer. (1) A storage device in which data is 
assembled temporarily during data transfer. (2) During 
1/0 operations, a portion or real storage from which 
data is read or into which data is writtten. 



cardless system. A system /370 model 1 15/125 confi- 
gured without a card reader or card punch, but with 
an IBM 3540 diskette input/output unit, 

Channel program. One or more Channel Command 
Words (CCWs) that control(s) a specific sequence 
of channel operations. Execution of the specific 
sequence is initiated by a single start I/O instruction. 

channel program translation. In a channel program, 
replacement, by software, of virtual addresses with 
real addresses. 

command control block (CCB). A 16-byte field 
required for each channel program executed by 
physical IOCS. This field is used for communication 
between physical IOCS and the problem program. 



communicaton region. An area of the supervisor 
set aside for interprogram and intraprogram communi- 
cation. It contains information useful to both the 
supervisor and the problem program. Abbreviated 
comreg. (Not to be confused with the COMRG macro 
instruction). 

control program. A program that is designed to 
schedule and supervise the performance of data 
processing work by a computing system. 

control registers. A set of registers used for operating 
system control of relocation, priority interruption, 
program event recording, error recovery, and masking 
operations. 

core-wrap mode. The method of operation that 
records the events of a trace in the PD area or an 
alternate area (used by PDAIDS). It is the default 
process when no output device for a PDAID trace 
has been specified. 
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DTF (define the file) macro instuc^ion. A macro 
instruction that describes the characteristics of a 
logical input/output file, indicates the type of 
processing for the file, and specifies the I/O areas 
and routines to process the file. 

default value. The choice among exclusive alternatives 
made by the system when no expHcit choice is 
specified by the user. A default value is indicated by 
underlining in tables listing parameters. 

diskette, A flexible magnetic oxide coated disk 
suitable for data storage and retrieval. 

dump. (1) To print out the contents of all or part 
of virtual storage or of auxiliary storage (2) The 
data resulting from the process as in (1). 

dynamic address translation (DAT). (1) The change 
of a virtual storage address to an address in real 
storage during execution of an instruction. (2) A 
hardware feature that performs the translation. 

emulator (1) * A device or computer program that 
emulates. (2) The combinafion of programming 
techniques and special machine features that permits 
a given computing system to execute programs 
written for another system. 
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environmental recording, editing, and printing 
(EREP). A program that processes the data 
contained on the system recorder file. 

error recovery procedures. Procedures designed to 
help isolate, and, when possible, to recover from 
hardware errors in equipment. The procedures are 
often used in conjunction with programs that record 
the statistics ot macnme malfunctions. 

error volume analysis (EVA). With this option, the 
system issues a message to the operator when a 
number of temporary read or write errors (specified 
by the user at system generation time) has been 
exceeded on a currently accessed tape file. 

event. An occurrence of significance to a task; 
typically, the completion of an asynchronous 
operation, such as input/output. 

extent. The physical locations on Input/Output 
devices occupied by or reserved for a particular 
volume. 

extended control mode. When PSW bit 12 is set to 1, 
the PSW format is changed from that used for 
standard System/360 operation: the channel mask 
bits, instruction length code, and interruption code 
are removed, and additional mode and mask bits are 
included. This is the extended control mode, in 
which all control registers are available to the system 
for control of faciUties that are particular to System/370. 
Abbreviated to EC mode. See also "Basic Control Mode'.' 



fetch, (1) To bring a program phase into real storage 
from a core image library or from the page data set 
for immediate execution. (2) The routine that 
retrieves requested phases and loads them. (3) The 
name of a macro instruction (FETCH) used to 
transfer control to the system loader. (4) To transfer 
control to the system loader, 

*file, A collection of related records treated as a unit. 
For example, one line of an invoice may form an item, 
a complete invoice may form a record, the complete 
set of such records may form a file, the collection of 
inventory control files may form a library, and the 
libraries used by an organization are known as its 
data bank. 

fixed page. A page in real storage that is not to be 
paged out. 

F/L Trace (Fetch/Load Trace). A program that records 
information about phases and transients as 
they are called from a core image library. 

"» 

GSVC Trace (Generalized Supervisor Calls Trace), 

A program that records SVC interrupts as they occur. 
All or a selected group of SVCs can be traced. 



H 

hard copy, A printed copy of machine output in a 
visually readable form, for example, a printed 
recording of the messages displayed on the System/370 
Model 125 video display unit. 

hard wait. A condition, usually caused by an error, 
in which the CPU is stopped and is not executing the 
microprogram, 

* hardware. Physical equipment, as opposed to the 
computer program or method of use, for example, 
mechanical, magnetic, electrical, or electronic devices. 
Contrast with software. 

Input Job Stream. A sequence of job control state- 
ments entering the system, which may also include 
input data. 

* interface. A shared boundary. An interface might 
be a hardware component to link two devices or it 
might be a portion of storage or registers accessed by 
two or more computer programs. 

interrupt. A break in the normal sequence of 
instruction execution. It causes an automatic transfer 
to a present storage location where appropriate 
action is taken. 

invalid page. A page that cannot be directly addressed 
by the dynamic address translation feature of the 
central processing unit. 

I/O area. An area (portion) of real storage into which 
data is read or from which data is written, the term 
buffer is often used in place of I/O area. 

I/O Trace (Input/Output Trace). A program that 
records I/O device activity for all or a selected group 
of I/O devices. 

IOCS (input/output control system). A group of 
macro instruction routines provided by IBM for 
handling the transfer of data between main storage 
and external storage devices. 

irrecoverable error. A hardware error which cannot 
be recovered from by the normal hardware and retry 
procedures. 

J 

job. (1) * A specified group of tasks prescribed as a 
unit of work for a computer. By extension, a job 
usually includes all necessary computer programs, 
linkages, files, and instructions to the operating 
system. (2) A collection of related problem programs, 
identified in the input stream by a JOB statement 
followed by one or more EXEC statements. 
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linkage editor. A processing program that prepares 
the output of language translators for execution. It 
combines separately produced object or load modules; 
resolves symbolic cross references among them, and 
generates overlay structures on request; and produces 
executable code (a load module) that is ready to be 
fetched into virtual storage. 

load. In programming, to enter instructions or data 
into storage or v/orking registers. In DOS/VS, to bring 
a program phase from a core image Ubrary into virtual 
storage for execution. 

logic module. The logical IOCS routine that provides 
an interface between a processing program and 
physical IOCS. 

* loop. A sequence of instructions that is executed 
repeatedly until a terminal condition prevails. 

LSERV (label cylinder display). A program that 
formats a listing of the label cyhnder located on 
SYSRES. 
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machine check analysis and recovery, A feature that 
checks the severity of a CPU hardware failure and 
attempts to recover from the interrupt. Abbreviated 
MCAR. 

machine check interrupt. The interrupt that occurs 
if the CPU fails to operate. 

main page pool. The set of all page frames in real 
storage not assigned to the supervisor or one of the 
real partitions. 

main storage. (1) The real address area of virtual 
storage. Contrast with auxiHary storage. (2) All 
program addressable storage from which instructions 
may be executed and from which data can be 
loaded directly into registers. 

microprogram. A set of basic or elementary machine 
instructions that is loaded into control storage to 
control CPU operations. 



transferring records over the multiplexer charmel, 
time sharing it on a byte basis. 

multiplexer mode. A means of transferring records 
to or from low-speed I/O devices on the multiplexer 
channel, by interleaving bytes of data. The multi- 
plexer channel sustains simultaneous I/O operations 
on several subchannels. Bytes of data are interleaved 
and then routed to or from the selected I/O devices 
or to and from the desired locations in main storage. 
Multijpiex mode is sometimes referred to as byte mode. 

multiprogramming system. A system that controls 
more than one program simultaneously by interleaving 
their execution. 

multitasking. The concurrent execution of one main 
task and one or more subtasks in the same partition. 



offline. (1) * Pertaining to equipment or devices 
not under control of the central processing unit. 
(2) Pertaining to program error diagnosis without 
using the computer system (offline program 
debugging). 

online. (1) Pertaining to equipment or devices under 
control of the central processing unit. (2) Pertaining 
to a user's ability to interact with a computer. 

online test executive program (OLTEP). The control 
program of the online test system. OLTEP is the 
interface between the online test and the operating 
system. 

operand. (1) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (2) Information entered with a command 
name to define the data on which the command 
processor operates and to control the execution of 
the command processor. 

overflow. (1) That portion of the result of an 
operation that exceeds the capacity of the intended 
unit of storage. (2) Pertaining to the generation of 
overflow as in (1). 



module. A program unit that is discrete and 
identifiable with respect to compiling, combining 
with other units, and loading, for example, the input 
to, or output from, an assembler, compiler, linkage 
editor, or executive routine. 

multiplexer channel. A channel designed to operate 
with a number of I/O devices simultaneously on a 
byte basis. That is, several I/O devices can be 



page. (1) A fixed-length block of instructions, data, 
or both, that can be transferred between real storage 
and external page storage. (2) To transfer instructions, 
data, or both between real storage and external page 
storage. 

page data set. An extent in auxihary storage, in 
which pages are stored. 
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page fault. A program interruption that occurs when 
a page that is marked "not in real storage" is referred 
to by an active page. Synonymous with page translation 
exception. 

page frame. A 2K block of real storage that can 
contain a page. 

page frame table. In DOS/VS, a table that contains 
an entry for each frame. Each frame table entry 
describes how the frame is being used. 

processor. (1) * In hardware, a data processor. (2) * In 
software, a computer program that includes the com- 
piling, assembling, translating, and related functions 
for a specific programjning language. RPG II processor, 
FORTRAN processor. (3) Same as processing program. 

Private Second Level Directory (PSLD). The Private 
Second Level Directory is a table, located in the 
Supervisor and containing the highest phasenames 
found on the corresponding directory tracks of the 
Private Core Image Library. 

page pool. The set of all page frames that may 
contain pages of programs in virtual mode. 

page table (PGT). A table that indicates whether a 
page is in real storage and correlates virtual addresses 
with real storage addresses. 

page translation exception. A program interruption 
that occurs when a virtual address cannot be translated 
by the hardware because the invaUd bit in the page 
table entry for that address is set. See also segment 
translation exception, translation specification 
exception. 

paging. The process of transferring pages between 
real storage and the page data set. 

* parameter. A variable that is given a constant value 
for a specific purpose or process. 

physical IOCS. Macro instructions and supervisor 
routines (Channel Scheduler) that schedule and 
supervise the execution of channel programs. 
Physical IOCS controls the actual transfer of records 
between the external storage medium and real 
storage, 

problem determination aids (PDAID). Programs that 
trace a specified event when it occurs during the 
operation of a program. The traces provided are: 
QTAM Trace, I/O Trace, F/L Trace, and GSVC 
1 rsLCC. 

problem program. (1) The user's object program. It 
can be produced by any of the language translators. 
It consists of instructions and data necessary to solve 



the user's problem. (2) A general term for any 
routine that is executed in the data processing 
system's problem state; that is, any routine that 
does not contain privileged operations. (Contrasted 
with Supervisor.) 

processing program. (1) A general term for any 
program that is not a control program. (2) Synonymous 
with problem program. 

program event recording. A System/370 feature that 
enables a program to be alerted to specific events. 
Abbreviated PER. 



R 
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QTAM Trace. A program that records certain 
supervisor and I/O activities on tape or in core-wrap 
mode. 

queue. (1) A waiting line or list formed by items in 
a system waiting for service; for example, tasks to 
be performed or messages to be transmitted in 
message switching system. (2) To arrange in, or 
from, a queue. 



real address. 

storage. 



The address of a location in real 



real address area. In DOS/VS, the area of virtual 
storage where virtual addresses are equal to real 
addresses. 

real mode. In DOS/VS, the mode of a program that 
may not be paged. 

real storage. The storage of a System/370 computing 
system from which the central processing unit can 
directly obtain instructions and data, and to which it 
can directly return results. Synonymous with processor 
storage. 

real partition. In DOS/VS, a division of the real 
address area of virtual storage that may be allocated 
for programs that are not to be paged, or programs 
that contain pages that are to be fixed. 

recovery management support. The facilities that 
gather information about hardware reliability and 
allow retry of operations that fail because of CPU, 
I/O device, or channel errors. Abbreviated to RMS. 

reenterable. The attribute of a set of code that 
allows the same copy of the set of code to be used 
concurrently by two or more tasks. 

reliability data extractor (RDE). A function that 
provides hardware reliability data that is analyzed by 
IBM. 
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relocatable library. A library or relocatable object 
modules and IOCS modules required by various 
compilers. It allows the user to keep frequently used 
modules available for combination with other 
modules without recompilation, 

resource. Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the 
central processing unit, data files, and control and 
processing programs. 

Rotational Position Sensing. A standard feature of IBM 
3330/3333/3350 and an optional feature of IBM 3340 
disk storage devices. It permits a device to disconnect 
from a block multiplexer channel (or its equivalent on 
Model 3115/3125 CPUs) during rotational positioning 
operations, thereby allowing the channel to service other 
devices on the channel during the positioning delay. 

routine. An ordered set of instructions that may have 
some general or frequent use. 

Second Level Directory (SLD). The table, located 
in the Supervisor and containing the highest phase- 
names found on the corresponding directory tracks 
of the system core image, 

segment. A continuous 64K area of virtual storage, 
which is allocated to a job or system task. 

segment table (SGT). A table used in dynamic 
address translation to control user access to virtual 
storage segments. Each entry indicates the length, 
location, and availability of a corresponding page 
table. 

segment translation exception. A program interruption 
that occurs when a virtual address cannnot be translated 
by the hardware because the invalid bit in the segment 
table entry for that address is set. See also page 
translation exception, translation specification 
exception. 

self-relocating. A programmed routine that is loaded 
at any double word boundary and can adjust its 
address values so as to be executed at that location. 

self-relocating program. A program that is able to 
run in any area of storage by having an initialization 
routine to modify all address constants at object time. 

selector channel. A channel designed to operate with 
only one I/O device at a time. Once the I/O device is 
selected, a complete record is transferred one byte at 
a time, 

SEREP. A stand-alone environment recording, 
editing, and printing program that makes the data 
contained in an error logout area of real storage 
available for further analysis. 



Shared Virtual Area (SV A): The last part of the 
virtual system address space that contains phases 
which are reenterable and relocatable and which can 
be shared between partitions. 

-Soft wait. A condition in which the CPU has stopped 
processing but continues to handle any requested 
interruptions. 

stand-alone dump, A program that displays the 
contents of the registers and all of real storage and that 
runs independently and is not controlled by DOS/VS. 

subtask. A task in which control is initiated by a 
main task by means of a macro instruction that 
attaches it. 

* storage protection. An arrangement for preventing 
access to storage for either reading, or writing or 
both. 

system generation. The process of tailoring the IBM 
supplied operating system to user requirements. 

system debugging aids. A set of routines provided 
to trace specific program events by using the program 
event recording facilities. Abbreviated SDAIDS. 

System Directory List (SDL). A list of highly used 
phases (either only in the system CIL or also in the 
SVA). This list is placed in the SVA. 

system recorder file. The data file that is used to 
record hardware reliabiUty data. 

T 

task, A unit of work for the central processing unit 
from the standpoint of the control program, 

task selection. The supervisor mechanism for 
determining which program should gain control of 
CPU processing. 

teleprocessing. The processing of data that is received 
from or set to remote locations by way of telecom- 
munication lines. 

terminal. (1) * A point in a system or communication 
network at which data can either enter or leave. (2) Any 
device capable of sending and receiving information 
over a communication channel. 

Terminating partition. This is a partition owning a 
program which is in the process of being terminated 
either because of a program cancel condition or 
because of EOJ. 

trace. (1) To record a series of events as they occur. 
(2) The record of a series of events. 

* tracing routine. A routine that provides a historical 
record of specified events in the execution of a program. 
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track hold, A function for protecting DASD tracks 
that are currently being processed. When track hold is 
specified in the DTF, a track that is being modified by 
a task in one partition cannot be concurrently accessed 
by a task or sub task in another partition. 

transient area. An area in the supervisor used for 
temporary storage of transient routines, such as non- 
resident supervisor call or error-handling routines. 

transient routines. These self-relocating routines are 
permanently stored on the system residence device 
and loaded (by the supervisor) into the transient area 
when needed for execution. 

translation specification exception. A program inter- 
ruption that occurs when a page table entry, segment 
table entry, or the control register pointing to the 
segment table contains information in an invalid 
format. See also page translation exception, segment 
translation exception. 



U 



user program, see problem program. 

unrecoverable error, see irrecoverable error, 

utility program. A program designed to perform 
a routine task, such as transcribing data from one 
storage device to another. 



V 



virtual address. An address that refers to virtual 
storage and must, therefore, be translated into a real 
storage address when it is used. 



virtual address area. In DOS/VS, the area of virtual 
storage whose addresses are greater than the highest 
address of the real address area. 

Virtual mode. In DOS/VS, the mode of a program 
which may be paged. 

virtual storage.'' A'ddressable space that appears to the 
user as real storage, from which instructions and data 
are mapped into real storage locations. The size of 
virtual storage is limited by the addressing scheme of 
the computing system and by the amout of auxiHary 
storage available, rather than by the actual number 
of real storage locations. 

virtual storage access method (VSAM). VSAM is an 

access method for direct or sequential processing of 
fixed and variable length records on direct access 
devices. The records in a VSAM file can be organized 
either in logical sequence by a key field (key sequence) 
or in the physical sequence in which they are written 
on the file (entry-sequence). A key sequenced file has 
an index, an entry-sequenced file does not. 

virtual telecommunications access method (VTAM). 

A set of IBM programs that control communications 
between terminals and application programs running 
under DOS/VS, OS/VSl , and 0S/VS2. 

volume. (1) That portion of a single unit of storage 
media which is accessible to a single read/write mechanisn 
for example, a drum, a disk pack, or part of a disk 
storage module. (2) A recording medium that is 
mounted and dismounted as a unit, for example, a reel, 
or magnetic tape, a disk pack, a data cell. 

VSAM access method servies. A multifunction utility 
program that defines VSAM files and allocates space 
for them, converts indexed sequential files to key- 
sequenced files with indexes, facilitate data portability 
between operating systems, creates backup copies of 
files and indexes, helps make inaccessible files accessible, 
and lists file and catalog entries. 

VTAM. Virtual telecommunications access method. 
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see also dumps 
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(PDUMP) 2.89 
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see also DOSVSDMP 2.25 
Free List Pointer (FLPTR) 4.56, A. 1 2 



dumping, SDAID output class 2 (GPR) 2.89 
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hands-on debugging 1.4 
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during IPL 2.193 
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messages, list of 2.192, 3.3, 4.8 
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see DOSVSDMP 2.25 
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IDAL block 4.128, A. 15 
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forLIOCS 4.65 

forVSAM 4.76 
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causes 1.13 
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operator flowchart 3.28 
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IT option table 4.104 



/iT 



\_J 



gathering information 1.17, 4.4 
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1.4 Index 



DOS/VS Serviceability Aids and Debugging Procedures 



■ i 






label information cylinder 2. 1 1 3 

for DASlVdiskette labels 2.1 17 
for tape labels 2.116 
label information display program (LSERV) 2. 1 1 2 
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layout of SYSRES 2.114 
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line mode table A. 10 
LIK A.4 
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LOCDRE, SD AID output class 2.89 
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LOG command 2. 1 84 
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LTK A.4 
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Machine C3ieck Analysis and Recovery (MCAR) 2.212 

general flow of processing (illustration) 2.208 
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maintenance program selection (Model 115/125) 1.25, 2.246 
manual frame (Model 158) 2.152 
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example of 2.106 
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MOD macros 4.68 
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modes of output, for PDAID 2.44 



module names and prefixes 4.68 
Monitor call instruction A. 9 
MVCOM macro 4.34 
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NICL 4,46, A.13 
NOLOG command 2.184 
non-critical area 2. 1 8 
non-destroying dump 2.94 
non-translating dump, example of 



INDEX 



2.29 



o 

OBJMAINT utiUty 2.142 

OC option table 4.111 

offline debugging, program debugging 1.28, 4.4 

OLTEP (Online Test Executive Pro-am) 2.250 

operators video console display unit 1,25 

see also Models 115/125 displays 

see also Model 158 frames 
operator commands for RMS 2.219, 2.205 
operators flowcharts 

see flowcharts, for the operator 



page enqueue trace 2.91 
page frame table 4. 1 20 

example of (in a dump output) 4.125 , A. 15 
page handling trace 2.91 
page management tables 4.118 

boundary box 4.121 

example of dumping using SDAID output class 05 2. 107 

example of interpreting in a dump output 4.125 , A. 15 

interrelationship, illustiation of 4. 1 23 

page frame table 4. 1 20 

page frame table extension 4. 1 20 

page table 4.118 

segment table 4.118 
page table 4.118 

example of (in a dump output) 4. 1 25 , A, 1 5 

explanation of the contents of 4.119 

initialization 4.118 
page tracing routines 2. 9 1 

example of 2.109 
page translation exception trace 2.91 
PAGETAB, SDAID output class option 2.89 
partition communication regions (COMREGs) 4.35 , A.13 
partition dump 2.12 
Partition Identification Key (PIK) A.3 
partition save area 4.112 
PC option table 4.110 
PD address table A.2 
PDarea 2.63, A.14 
PD standard preface table A.2 
PDAID and SDAID used together (concurrentiy) 2.44 
PDAID output 

modes (devices) 2.44 

selecting a device 2.67 
PDAID trace routines 2.43 

dumping the PDAID alternate area 2.68 

entry locations 2.65 

error messages 2.69 

F/L trace 2.49 

GSVC trace 2.52 

initiating the trace routines 2.66 

I/O tiace 2.46 

job stream entry examples 
viaSYSIPT 2.78 
viaSYSLOG 2.80 

operator's flowchart for initializing 2. 7 1 

options and control statements 2.70 

QT AM trace 2.55 
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INDEX P (continued) 

specifying an alternate area 2.68 

system requirements 2.44 

VTAM trace 2.60 
PDAID transient dump, see transient dump 
PDLIST 2.45 

PDS (Page Data Set), copying 2. 1 3 3 
PDUMP, SDAID output class 2.88 
PDUMP macro 2.36 

information dumped 2.36 
PDZAP 2.139 

PER (Program Event Recording) A. 8 
PHO option table 4.109 
Physical IOCS 4.62 
physical transient area 2. 21 1 

dumping, see transient dump 
PIB (Program Information Block) 4.92, A.13 
PIB2 (Program Information Block extension) 4.96 
PIK (Partition Identification Key) A.3 
POWER/VS 

problem analysis for programs running under 4. 30 

service aids for A.3 8 

file dump program A.3 8 
prefixes for IBM modules 4.68 
PRINT GEN, PRINT NOGEN assembler language statement 

example of 4.70 
printing the contents of SYSREC, see EREP 
printing the contents of SYSVIS, see SYSVIS dump 
program check interrupt (PGMCHK) 

causes 1.15 

example of 2.13, 2.14 

isolation of cause, programmers flowchart 4.20 

mSVA 2.14 

list of codes 4.115 

operation action 1.15 

operator flowchart 3.29 
programmers flowcharts 

see flowcharts 
PSW (Program Status Word) 2. 1 89 

displaying, dumping, SDAID output class 1 (PSW) 2.89 
see also ALTER/DISPLAY console operation 
PUB (Physical Unit Block); 4.48, A.13 
PUB2 2.219 
PUB ovmership, PUBOWNER 4.53 



QTAM trace 2.55 



R 

RAS transient area 2.21 1 

RDESUM, option of EREP 2.229 , A.3 7 

RDE (Reliability Data Extractor) 2. 2 1 6 

EREP RDE tape 2.232 
real storage areas destroyed by the stand-alone dump program 

example of A, 12 

see also non-critical a|pa^.Zli8 
real storage dump (DUMPREAL) 2.89 
re-enterable modules 4.68 

register alteration, see ALTER/DISPLAY console operations 
Reliability, Availability arid Serviceability (RAS) 1.21 
Reliability Data Extractor (RDE) 2. 2 1 6 
relocation factor, example of using 2. 1 4, 2. 1 10 

see also Unkage editor map 
REQID A.5 

RJE, BSC I/O trace A.38 
RMS (Recovery Management Support) 1.21, 2.204 

components 2.211 

detailed description 2. 2 1 2 

general description 2.204 
RMSR (Recovery Management Support Recorder) 2 204 

see also SYSREC 



ROD command 2.219 
RPL (Request Parameter List) 
RSERV 2.125 



4.76 
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save areas 

ABSAVEarea 4.114 

label save area, illustration of 4.113 

partition and label save area 4.114 

save areas for job accounting 4. 1 1 7 

system save areas 4. 1 1 6 

user exit routine save areas, illustration of 4.1 15 
save usage counters 2.180 
SDarea 2.95 

SDAID and PDAID used together (concurrently) 2.87 
SDAID initializing output, example of 2.105 
SDAID output 2.89 
SDAID trace routines 2. 84 

altering SDAID parameters after initialization 2.97 

caution before using 2.84 

description and operation of the routines 2.91 

dump on program check 2.95 

events 2.87 

examples of output 2.105 

general register alter trace (GA) 2.92 

initializing 2.96 
example of 2.106 
flowchart 2,99 

initializing output 2.105 

instruction trace (IF) 2.92 

job entry example 2.106 

non-destroying dump 2.94 

output information 2.105 

page tracing routines 2.91 

stop and dump facilities 2.84 

stop and dump routines 2.93 

stop on address 2.93 

storage alter trace (SA) 2.92 

successful branch trace (BR) 2.92 

system requirements 2.85 

terminating 2.87 
segment table 4.118 

example of (in a dump output) 4. 1 25 , A. 1 5 

interrelationship to page table, illustration of 4.123 
SELECT byte in SYSCOM A,5 
SELECT option of EREP 2.228 
SEREP 1.24, 2.242 
serviceability aids 1.3 

provided by the operators console 2.148 

visual index 2.3 

see dumps 

see also trace routines 

see also hardware error recording 
serviceability aids from the operators console 

ALTER/DISPLAY console operation 2. 1 4 8 

clear real storage 2. 1 79 

instruction stepping 2.162 

Models 115/125 console dump operation 2.176 

Models 115/125 save usage counters 2.180 

stop on address compare 2.168 

store status 2.178 
SHOWCB macro 4.77 
snap shot dump 

PDUMP macro 2.36 

SDAID PDUMP output class 2.88 
soft wait 1.10 

isolation of cause, programmers flowchart 4. 1 1 

operators action, flowchart 3. 1 7 . 3.18 
SSERV 2.125 

statements, job control 2.184 
stand-alone dump 2.18 

example of A. 1 1 

generating 

seeDUMPGEN 2.15 
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S (continued) 

see also DOSVSDMP 2.25 
stand-alone EREP (SEREP) 1.24, 2.242 
standard dump, non-translating dump, example of 2.35 
status, see MODE command 2.221 
stop and dump routines 2.93 
stop on address (SDAID) 2.93 
stop on address compare (all Models) 2.168 
stop on event (SDAID) 2.84, 2.93 
stopping the SDAID non-destroying dump 2.94 
storage alter trace 2.92 
storage alteration 

using the ALTER command 2.6 

using the ALTER/DISPLAY console feature 2. 1 4 8 
storage areas destroyed by the stand-alone dump 
program 2.22 

example of A. 12 

see also non-critical area 
storage dumps, pictorial representation of 1.19 

see also dumps 
store status 2.178 

sub-system ID, see EPL reason information 
successful branch trace 2.92 

example of output 2. 1 10 
SUM option of EREP 2.226, A. 3 7 
supervisor call trace, see GSVC trace 2.52 
supervisor calls 4.88 
supervisor communication macros 2.36 

DUMP macro 2.38 

JDUMP macro 2.38 

PDUMPmaao 2.36 
supervisor information blocks 

PIB 4.92 

PIB extension (PIB2) 4.96 

see also page management tables 

see also supervisor I/O tables 
supervisor I/O tables 

(interrelationships are illustrated on the foldout at 

the back of this manu al) 

CCB copy block 4.128 

CCW copy block 4.132 

CCW/TCB 4.133 

channel bucket 4.58 

channel control table 4.58 

channel queue 4.56 

error recovery block, error block 4.60 

error queue 4.60 

FAVP 4,54 

FICL 4.46 

fix information block 4.134 

FLPTR 4.56 

FOCL 4.48 

IDAL block 4.128 

JIB 4.54 

LMT A, 10 

LUB 4.46 

NICL 4.46 

PUB 4.48 

PUBOWNERSHIP 4.53 
supervisor, organization of 4.33 
SUPVISOR, SDAID output class 2.89 
SVC trace, see GSVC trace 2.52 
SYSCOM (System communication region) 4.42 , A. 12 
SYSLOGID A,3 
SYSREC 2.215 

relationship 

between SYSREC record types and EREP 2.210 
SYSRES extent, format and contents 2. 1 14 
system dump 2.12 
system information required 

to isolate the cause of malfunctions 4.4 
system recorder file see SYSREC 
system requirements for 

EREP 2.223 

EVA 2.218 



LSERV 2.112 

PDAID 2.44 

SDAID 2.85 

RMS 2.204 

TES 2.217 

transient dump 2.29 
system save areas 4.116 
system status information, example of 
SYSVIS dump 2.133 



INDEX 



2.200 



Task Interrupt Key (TIK) A.4 

task timer support 4.107 

Tape Enor Statistics (TES) 2. 2 1 7 

EREP 2.233 

ESTVUT 2.235 
TES, option of EREP 2.231, A.35 
TESTCB macro 4.77 
threshold values for EFL 2. 2 1 2 
TIK A.4 
TKREQID A.5 

TOLTEP (Teleprocessing Online Test Executive 
Program) 2.252 
trace routines 2.43 

PDAID 2.43 

SDAID 2.84 
tracing a loop 

instruction step method 2. 162 

using the SDAID BR/IF TRACE, example of 2. 1 10 
transient areas (illustration of) 2.111 
transient dump 2.25 

transient routines (A, B and R transients) 2.21 1 
translating addresses, see converting addresses 
translating dump, example of 2. 1 3, A. 1 1 
translation exception trace, see page tracing routines 

u 

unintended program loop 1.8 

programmers flowchart 4.13 

operators flowchart 3.22 
user exit routine save areas 4. 1 14 
user exit routine support, tables used by 4.103 

Abnormal Termination (AB) 4.106 

Interval Timer option (IT) 4.104 

Operator Communication (OC) 4.111 

Page Fault Handling Overlap (PHO) 4.108, 4.109 

Program Check (PC) 4.110 

Task Timer (TTTAB) 4.107 

V 

video display unit Models 115/125 

example of displays, see Model 115/125 displays 
virtual storage, organization of 4.33 
Virtual Storage Access Method (VSAM) 4.76 
Volume Table of Contents (VTOC) 2. 1 28 
VSAM (Virtual Storage Access Method) 4.76 
VTAM trace 2.60 
VTAM Buffer Pool trace 2. 6 2 
VTOC (Volume Table of Conten ts) 2. 1 28 
VTOC display program (LVTOC) 2.128 



w 



WAIT macro, example 4.64 
wait states 

causes of a soft wait 1.11 

coded messages, list of 2.192, 3.3, 3.4 

due to a hardware failure 2. 196 

during IPL 2.193 

during program operation 2.194 

isolation of cause programmers flowchart 4.9 

location of 2.192 

operator action 1.11 

operators flowchart 3.16 
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PUB (See Figure 4.7. 
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PUB entries for 
channel 3 



PUB entries for 
channels 4, 5, and 6, 
if supported 




X FF indicates 
that the channel 
is not supported 
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Chan 6 



FLPTR 
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CCB pointer 
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INTERRELATIONSHIPS BETWEEN 
I/O TABLES AND 
INFORMATION BLOCKS 






Channel 

Control 

Table 

(See Figure 4.13. 



If program is virtual, this 
^ J pointer points to the 

^ copied CCB, which in 

turn points to the copied 
CCW block (s). 



Chan 




Chan 1 




Chan 2 




Chan 3 




Chan 4 




Chan 5 




Chan 6 
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CCB Copy Block 



CCW Copy Block(s) 



IDAL Block 



(Refer to Chapter 13 
in Section 4 for a 
description of Channel 
Program Translation.) 
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Channel Buckets (See Figure 4.14.) 

One 24 byte entry for each channel; 

no entry is made for channels not supported. 



Input/output control system in user problem program area. 



CCB (Refer to Chapter 5 in Section 4.) 




Channel Program (Refer to Chapter 5 in Section 4.) 
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Logical IOCS 
)> (Refer to Chapter 4 
in Section 4.) 



CCB (Refer to Chapter 5 in Section 4.) 



Channel Program (Refer to Chapter 5 in Section 4.) 
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Physical IOCS 
j^ (Refer to Chapter 4 
in Section 4.) 



J 



Error Recovery Block (See Figure 4.15.) 



Up to 25 entries max. each entry being 44 bytes 



Explanation of the figure. 

The contents of the tables indicate the following: 
m The system has 3 partitions. 

• Logical unit SYSRDR is assigned to device address OOC. 
S YSCL B is unassigned. 

• SYSLST has a temporary assignment to device address 131. 

• Device OOC is queued and chained, indicating two I/O 
requests for this unit 

• The CCB pointer for the first I/O request points to a 
LIOCS DTF in the user program that is running in real mode. 

• The CCB pointer for the second I/O request points to a 
PIOCS CCB and channel program in a user program 
running in virtual mode. 

I/O channels 4, 5, and 6 are not supported by the system. 

The interrelationship between the Supervisor I/O tables 
and information blocks, and the user program IOCS. 
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